@apocaliss92/nodedreame 1.12.2 → 1.12.4

package/dist/index.d.cts

@@ -976,6 +976,81 @@ declare class VacuumCapabilityResolver implements CapabilityResolver {
     resolve(model: string): DeviceCapabilities;
 }
 
+/**
+ * Public types for the video control-plane. The Dreamehome cloud fronts several
+ * camera backends ("vendors"); a device advertises which ones it supports and
+ * which one it is currently provisioned on. This module models only the
+ * control-plane (token + session negotiation); the media transport per vendor
+ * is built on top of it.
+ */
+/** Camera backend a device streams through. `tx` = Tencent, `ali` = Aliyun LinkVisual. */
+type VideoVendor = 'tx' | 'ali';
+/** Short-lived token minted by `tx/user/accesstoken`, used by the video endpoints. */
+interface VideoAccessToken {
+    /** Opaque bearer for the third-video service (distinct from the account token). */
+    readonly token: string;
+    /** Numeric video-service user id, as a string. */
+    readonly userId: string | null;
+    /** Epoch-ms at which {@link token} expires (converted from the cloud's epoch-seconds). */
+    readonly expiresAt: number;
+}
+/**
+ * A device's video profile, derived from its cloud record. Tells you whether the
+ * device has a camera, which vendors it supports, which one it is on now, and —
+ * when on Aliyun — its LinkVisual `iotId` (the id every LinkVisual call needs).
+ */
+interface DeviceVideoProfile {
+    /** Dreame device id (the `did`). */
+    readonly did: string;
+    /** Model code, e.g. `dreame.vacuum.r2538z`. */
+    readonly model: string;
+    /** Human product name, e.g. `X50 Ultra Complete`. */
+    readonly displayName: string | null;
+    /** True when the device exposes a camera stream (`permit === "video"`). */
+    readonly videoCapable: boolean;
+    /** The vendor the device is currently provisioned on (`''` in the record → null). */
+    readonly currentVendor: VideoVendor | null;
+    /** Vendors the device can use, in cloud-declared order. */
+    readonly supportedVendors: readonly VideoVendor[];
+    /** True when the cloud picks the vendor dynamically at session time. */
+    readonly dynamicVendor: boolean;
+    /** Aliyun LinkVisual device id, when the device is on (or has been on) Aliyun. */
+    readonly iotId: string | null;
+    /** Whether the device is online. */
+    readonly online: boolean;
+}
+/**
+ * A device's TENCENT IoT triple, from `tx/mgr/dev/getIdentity`.
+ *
+ * Present only while the device is provisioned on the `tx` vendor. The secrets
+ * are session-scoped credentials for the Tencent IoT plane — never log them.
+ */
+interface TencentDeviceIdentity {
+    readonly productId: string;
+    readonly deviceName: string;
+    /** `<productId>/<deviceName>`, as the cloud composes it. */
+    readonly deviceId: string | null;
+    readonly secretId: string | null;
+    readonly secretKey: string | null;
+}
+/**
+ * The xp2p session descriptor from `tx/dev/getP2PInfo`.
+ *
+ * OPAQUE by nature: measured at 35 characters on an X50 and not JSON — it is
+ * the handle Tencent's proprietary xp2p SDK consumes to open the UDP P2P
+ * session, not a URL anything else can dial. It is carried, never parsed.
+ */
+interface TencentP2PDescriptor {
+    readonly p2pInfo: string;
+}
+
+/** What the device reports about its video SDK. */
+interface VideoVendorStatus {
+    readonly vendor: VideoVendor | null;
+    /** `1` once the SDK for {@link vendor} is up. A switch is not done until this. */
+    readonly initStatus: number | null;
+}
+
 /**
  * MIoT surface of the Dreame camera service (SIID 10001), reversed byte-exact
  * from the r2538z (X50) React-Native plugin `Monitor` model. Every camera
@@ -2076,6 +2151,39 @@ declare class VacuumDevice extends BaseDevice<VacuumDeviceEvents> {
         /** Reuse an existing relay minter (e.g. a shared {@link DreameVideoSession}). */
         relay?: RelayMinter;
     }): Promise<DreameCameraController>;
+    /**
+     * What video backend this robot is on, and whether that backend's SDK is up.
+     *
+     * A CACHED read by default: the cloud shadow answers for a robot on its dock
+     * without waking it, which is the whole point of asking before deciding how
+     * to stream. Pass `{ live: true }` when the answer must be current — while a
+     * switch settles, for instance.
+     */
+    readVideoVendorStatus(opts?: {
+        live?: boolean;
+    }): Promise<VideoVendorStatus>;
+    /**
+     * Move this robot onto a video backend, and WAIT until it is really there.
+     *
+     * The two backends are not interchangeable: measured on an X50 on
+     * 2026-09-16, a robot on `tx` offers only Tencent's proprietary UDP P2P
+     * plane (`getRtcInfo` answers 404), while the same robot on `ali` streams
+     * through a plain RTMP relay this library implements end to end. So which
+     * one it sits on decides whether it can be streamed at all.
+     *
+     * The device reports the NEW vendor before its SDK is up, which is why the
+     * app polls rather than trusting the action's return — and why this resolves
+     * on `initStatus === 1` and not a moment earlier. A half-switched robot
+     * answers questions about a backend it cannot yet serve.
+     *
+     * Only meaningful on a dual-vendor device (`videoDynamicVendor`, with the
+     * target in `defaultVendors`); a device that cannot move simply never
+     * settles, and this reports that as a timeout rather than a silent success.
+     */
+    setVideoVendor(vendor: VideoVendor, opts?: {
+        timeoutMs?: number;
+        pollIntervalMs?: number;
+    }): Promise<VideoVendorStatus>;
     /** Props worth seeding on start() / polling — exported for the facade. */
     static readonly DEFAULT_PROPS: readonly [{
         readonly siid: 2;
@@ -3050,50 +3158,6 @@ declare function createDumper(target: DumperDevice, options?: DumperOptions): Du
  */
 declare function createClientDumper(client: Nodreame, options?: DumperOptions): Dumper[];
 
-/**
- * Public types for the video control-plane. The Dreamehome cloud fronts several
- * camera backends ("vendors"); a device advertises which ones it supports and
- * which one it is currently provisioned on. This module models only the
- * control-plane (token + session negotiation); the media transport per vendor
- * is built on top of it.
- */
-/** Camera backend a device streams through. `tx` = Tencent, `ali` = Aliyun LinkVisual. */
-type VideoVendor = 'tx' | 'ali';
-/** Short-lived token minted by `tx/user/accesstoken`, used by the video endpoints. */
-interface VideoAccessToken {
-    /** Opaque bearer for the third-video service (distinct from the account token). */
-    readonly token: string;
-    /** Numeric video-service user id, as a string. */
-    readonly userId: string | null;
-    /** Epoch-ms at which {@link token} expires (converted from the cloud's epoch-seconds). */
-    readonly expiresAt: number;
-}
-/**
- * A device's video profile, derived from its cloud record. Tells you whether the
- * device has a camera, which vendors it supports, which one it is on now, and —
- * when on Aliyun — its LinkVisual `iotId` (the id every LinkVisual call needs).
- */
-interface DeviceVideoProfile {
-    /** Dreame device id (the `did`). */
-    readonly did: string;
-    /** Model code, e.g. `dreame.vacuum.r2538z`. */
-    readonly model: string;
-    /** Human product name, e.g. `X50 Ultra Complete`. */
-    readonly displayName: string | null;
-    /** True when the device exposes a camera stream (`permit === "video"`). */
-    readonly videoCapable: boolean;
-    /** The vendor the device is currently provisioned on (`''` in the record → null). */
-    readonly currentVendor: VideoVendor | null;
-    /** Vendors the device can use, in cloud-declared order. */
-    readonly supportedVendors: readonly VideoVendor[];
-    /** True when the cloud picks the vendor dynamically at session time. */
-    readonly dynamicVendor: boolean;
-    /** Aliyun LinkVisual device id, when the device is on (or has been on) Aliyun. */
-    readonly iotId: string | null;
-    /** Whether the device is online. */
-    readonly online: boolean;
-}
-
 /** Shared inputs for every video control-plane call. Mirrors `listDevices`. */
 interface VideoRequestInput {
     session: DreameSession;
@@ -3125,6 +3189,37 @@ declare function getAliyunAuthCode(input: VideoRequestInput): Promise<string>;
 declare function getVideoFamilyId(input: VideoRequestInput & {
     videoToken?: string;
 }): Promise<string>;
+/**
+ * The device's TENCENT IoT triple.
+ *
+ * Only meaningful while the device sits on the `tx` vendor: the cloud answers
+ * `设备三元组不存在` ("the triple does not exist") otherwise, which this
+ * surfaces as a thrown {@link DreameError} like any other refusal — a device on
+ * `ali` has no Tencent identity, and that is a statement about the device, not
+ * a failure of the call.
+ */
+declare function getTencentIdentity(input: VideoRequestInput & {
+    did: string;
+    videoToken?: string;
+}): Promise<TencentDeviceIdentity>;
+/**
+ * The xp2p session descriptor for a device on the `tx` vendor.
+ *
+ * ## This may WAKE THE CAMERA
+ *
+ * It is the Tencent equivalent of asking for a stream, so it is never called
+ * as part of a status read.
+ *
+ * The result is opaque (see {@link TencentP2PDescriptor}) and is useless
+ * without an xp2p implementation: measured on an X50 on 2026-09-16, the
+ * sibling `tx/dev/getRtcInfo` — the TRTC path, which WOULD be portable — answers
+ * 404 for this model. So the only media plane Tencent offers this device is the
+ * proprietary UDP P2P one.
+ */
+declare function getTencentP2PInfo(input: VideoRequestInput & {
+    did: string;
+    videoToken?: string;
+}): Promise<TencentP2PDescriptor>;
 /**
  * Resolve a device's video profile (vendor, supported vendors, Aliyun iotId,
  * capability) from its cloud record. `did` is the Dreame device id.
@@ -3746,4 +3841,4 @@ interface ListDevicesInput {
 /** Enumerate the devices visible to the authenticated account (incl. shared). */
 declare function listDevices(input: ListDevicesInput): Promise<DreameDevice[]>;
 
-export { AI_FEATURE_BIT, AI_FEATURE_JSON_KEY, ALIYUN_REGION_ID, AUTO_SWITCH_JSON_KEY, type AacConfig, type AiDetectionRaw, type AudioInfoEvent, type AutoSwitchKey, type AutoSwitchRaw, type AvcConfig, BaseDevice, type BaseDeviceEvents, type BatchDeviceDataFetcher, type BrokerEndpoint, type CameraStreamHandle, type CapabilityResolver, ChargingStatus, type CleanOpts, CleaningMode, type ConsumableReading, type ConsumableSpec, type CreateDeviceArgs, DRIVE_DIRECTIONS, DefaultCapabilityResolver, type DetectionBox, type DeviceCapabilities, type DeviceConnectivity, type DeviceDump, type DeviceEvent, type DeviceVideoProfile, type DreameAiFeature, DreameApiError, DreameAuthError, DreameCameraController, type DreameCameraControllerInput, DreameCameraStream, type DreameCameraStreamEvents, type DreameCameraStreamInput, type DreameCloudState, type DreameConsumableKey, type DreameDevice, DreameDeviceOfflineError, DreameError, type DreameRegion, type DreameSession, DreameTransportError, DreameVideoSession, type DreameVideoSessionInput, type DriveDirection, type DumperOptions, type FrameSource, type FrameSourceFactory, type IotSession, LIBRARY_NAME, LV_STATUS, type ListDevicesInput, LvRtmpClient, type LvRtmpClientOptions, MONITOR_AIID, MONITOR_PIID, MONITOR_SIID, MONITOR_VENDOR_TOKEN, MODEL_CAPABILITIES as MOWER_MODEL_CAPABILITIES, MOWER_TASK_SUBSTATES, type MapBoundingBox, type MapCleanedAreaOverlay, type MapColorScheme, type MapDimensions, type MapFrameType, type MapLayer, type MapLayerType, type MapLowLyingArea, type MapObstacle, type MapPath, type MapPathType, type MapPoint, type MapPose, type MapRestrictedArea, type MapRoom, type MapRoomWall, type MapRun, type MapSegment, type MapStorey, type MapVirtualWall, type MapWallsInfo, type MiotAction, MiotError, type MiotProp, MiotState, type MonitorActionCaller, type MowerAvailableMap, type MowerCapabilities, MowerCapabilityResolver, MowerChargingStatus, type MowerConsumableKey, type MowerConsumableReading, type MowerContour, MowerControlAction, type MowerControlState, MowerDevice, type MowerDeviceInput, MowerFault, type MowerFaultSeverity, type MowerHeartbeat, type MowerMap, type MowerMapBoundary, type MowerMowPath, type MowerMowingProgress, type MowerPathEntry, type MowerPoint, type MowerSpotArea, MowerStatus, type MowerTaskDescriptor, MowerTaskStatus, type MowerTaskSubState, type MowerZone, Nodreame, type NodreameDeps, type NodreameEvents, type NodreameOptions, type OaSession, type ObstacleDetection, type OssFetchInput, type OssFetcherLike, PET_SOUNDS, type PersonFollowDetection, type PetSound, type PropertyChangedEvent, type PropertyResult, type PropertyState, type PropertyWrite, type RelayMinter, type RenderMowerSvgOptions, type RenderVacuumPngOptions, type RenderWifiSignalPngOptions, type StateChangedEvent, type StatusEvent, type StreamInfo, type StreamQueryInput, SuctionLevel, TALK_AUDIO_HEADER_G711A, TaskStatus, VACUUM_ACTIONS, VACUUM_CONSUMABLES, MODEL_CAPABILITIES$1 as VACUUM_MODEL_CAPABILITIES, VACUUM_MOVE, VACUUM_SIID, type VacuumActionKey, type VacuumCapabilities, VacuumCapabilityResolver, VacuumDevice, type VacuumGetMapInput, type VacuumMap, type VideoAccessToken, type VideoAccessUnitEvent, type VideoRequestInput, type VideoVendor, WaterVolume, type WifiSignalMap, type WifiSignalMapInput, aacSampleRate, aacToAdts, avccToAnnexB, consumableSpec, createClientDumper, createDumper, createIotSession, decodeAiFeature, decodeAutoSwitch, decodeAutoSwitchAll, decodeWifiSignalMap, encodeAiFeatureWrite, encodeAutoSwitchWrite, explainNoCameraChannel, extractMowerConsumableValues, getAliyunAuthCode, getDeviceVideoProfile, getMowerCapabilities, getVacuumCapabilities, getVideoAccessToken, getVideoFamilyId, hashAccessCode, isAuthRefusedError, isDreameConsumableKey, listDevices, loginByOauth, makeMonitorSession, mowerConsumableIndex, mowerFaultSeverity, parseAacConfig, parseAvcConfig, parseConnectivity, parseMowerConsumables, parseMowerHeartbeat, parseMowingProgress, parseObstacleData, parsePersonFollow, parseRelayUrl, pcm16ToALaw, pcm16leToALaw, remoteDriveValue, renderMowerSvg, renderVacuumPng, renderWifiSignalPng, resolveCapabilities, signApiGatewayRequest, streamQuery, supportedAutoSwitchKeys, toVideoProfile };
+export { AI_FEATURE_BIT, AI_FEATURE_JSON_KEY, ALIYUN_REGION_ID, AUTO_SWITCH_JSON_KEY, type AacConfig, type AiDetectionRaw, type AudioInfoEvent, type AutoSwitchKey, type AutoSwitchRaw, type AvcConfig, BaseDevice, type BaseDeviceEvents, type BatchDeviceDataFetcher, type BrokerEndpoint, type CameraStreamHandle, type CapabilityResolver, ChargingStatus, type CleanOpts, CleaningMode, type ConsumableReading, type ConsumableSpec, type CreateDeviceArgs, DRIVE_DIRECTIONS, DefaultCapabilityResolver, type DetectionBox, type DeviceCapabilities, type DeviceConnectivity, type DeviceDump, type DeviceEvent, type DeviceVideoProfile, type DreameAiFeature, DreameApiError, DreameAuthError, DreameCameraController, type DreameCameraControllerInput, DreameCameraStream, type DreameCameraStreamEvents, type DreameCameraStreamInput, type DreameCloudState, type DreameConsumableKey, type DreameDevice, DreameDeviceOfflineError, DreameError, type DreameRegion, type DreameSession, DreameTransportError, DreameVideoSession, type DreameVideoSessionInput, type DriveDirection, type DumperOptions, type FrameSource, type FrameSourceFactory, type IotSession, LIBRARY_NAME, LV_STATUS, type ListDevicesInput, LvRtmpClient, type LvRtmpClientOptions, MONITOR_AIID, MONITOR_PIID, MONITOR_SIID, MONITOR_VENDOR_TOKEN, MODEL_CAPABILITIES as MOWER_MODEL_CAPABILITIES, MOWER_TASK_SUBSTATES, type MapBoundingBox, type MapCleanedAreaOverlay, type MapColorScheme, type MapDimensions, type MapFrameType, type MapLayer, type MapLayerType, type MapLowLyingArea, type MapObstacle, type MapPath, type MapPathType, type MapPoint, type MapPose, type MapRestrictedArea, type MapRoom, type MapRoomWall, type MapRun, type MapSegment, type MapStorey, type MapVirtualWall, type MapWallsInfo, type MiotAction, MiotError, type MiotProp, MiotState, type MonitorActionCaller, type MowerAvailableMap, type MowerCapabilities, MowerCapabilityResolver, MowerChargingStatus, type MowerConsumableKey, type MowerConsumableReading, type MowerContour, MowerControlAction, type MowerControlState, MowerDevice, type MowerDeviceInput, MowerFault, type MowerFaultSeverity, type MowerHeartbeat, type MowerMap, type MowerMapBoundary, type MowerMowPath, type MowerMowingProgress, type MowerPathEntry, type MowerPoint, type MowerSpotArea, MowerStatus, type MowerTaskDescriptor, MowerTaskStatus, type MowerTaskSubState, type MowerZone, Nodreame, type NodreameDeps, type NodreameEvents, type NodreameOptions, type OaSession, type ObstacleDetection, type OssFetchInput, type OssFetcherLike, PET_SOUNDS, type PersonFollowDetection, type PetSound, type PropertyChangedEvent, type PropertyResult, type PropertyState, type PropertyWrite, type RelayMinter, type RenderMowerSvgOptions, type RenderVacuumPngOptions, type RenderWifiSignalPngOptions, type StateChangedEvent, type StatusEvent, type StreamInfo, type StreamQueryInput, SuctionLevel, TALK_AUDIO_HEADER_G711A, TaskStatus, VACUUM_ACTIONS, VACUUM_CONSUMABLES, MODEL_CAPABILITIES$1 as VACUUM_MODEL_CAPABILITIES, VACUUM_MOVE, VACUUM_SIID, type VacuumActionKey, type VacuumCapabilities, VacuumCapabilityResolver, VacuumDevice, type VacuumGetMapInput, type VacuumMap, type VideoAccessToken, type VideoAccessUnitEvent, type VideoRequestInput, type VideoVendor, WaterVolume, type WifiSignalMap, type WifiSignalMapInput, aacSampleRate, aacToAdts, avccToAnnexB, consumableSpec, createClientDumper, createDumper, createIotSession, decodeAiFeature, decodeAutoSwitch, decodeAutoSwitchAll, decodeWifiSignalMap, encodeAiFeatureWrite, encodeAutoSwitchWrite, explainNoCameraChannel, extractMowerConsumableValues, getAliyunAuthCode, getDeviceVideoProfile, getMowerCapabilities, getTencentIdentity, getTencentP2PInfo, getVacuumCapabilities, getVideoAccessToken, getVideoFamilyId, hashAccessCode, isAuthRefusedError, isDreameConsumableKey, listDevices, loginByOauth, makeMonitorSession, mowerConsumableIndex, mowerFaultSeverity, parseAacConfig, parseAvcConfig, parseConnectivity, parseMowerConsumables, parseMowerHeartbeat, parseMowingProgress, parseObstacleData, parsePersonFollow, parseRelayUrl, pcm16ToALaw, pcm16leToALaw, remoteDriveValue, renderMowerSvg, renderVacuumPng, renderWifiSignalPng, resolveCapabilities, signApiGatewayRequest, streamQuery, supportedAutoSwitchKeys, toVideoProfile };

package/dist/index.d.ts

@@ -976,6 +976,81 @@ declare class VacuumCapabilityResolver implements CapabilityResolver {
     resolve(model: string): DeviceCapabilities;
 }
 
+/**
+ * Public types for the video control-plane. The Dreamehome cloud fronts several
+ * camera backends ("vendors"); a device advertises which ones it supports and
+ * which one it is currently provisioned on. This module models only the
+ * control-plane (token + session negotiation); the media transport per vendor
+ * is built on top of it.
+ */
+/** Camera backend a device streams through. `tx` = Tencent, `ali` = Aliyun LinkVisual. */
+type VideoVendor = 'tx' | 'ali';
+/** Short-lived token minted by `tx/user/accesstoken`, used by the video endpoints. */
+interface VideoAccessToken {
+    /** Opaque bearer for the third-video service (distinct from the account token). */
+    readonly token: string;
+    /** Numeric video-service user id, as a string. */
+    readonly userId: string | null;
+    /** Epoch-ms at which {@link token} expires (converted from the cloud's epoch-seconds). */
+    readonly expiresAt: number;
+}
+/**
+ * A device's video profile, derived from its cloud record. Tells you whether the
+ * device has a camera, which vendors it supports, which one it is on now, and —
+ * when on Aliyun — its LinkVisual `iotId` (the id every LinkVisual call needs).
+ */
+interface DeviceVideoProfile {
+    /** Dreame device id (the `did`). */
+    readonly did: string;
+    /** Model code, e.g. `dreame.vacuum.r2538z`. */
+    readonly model: string;
+    /** Human product name, e.g. `X50 Ultra Complete`. */
+    readonly displayName: string | null;
+    /** True when the device exposes a camera stream (`permit === "video"`). */
+    readonly videoCapable: boolean;
+    /** The vendor the device is currently provisioned on (`''` in the record → null). */
+    readonly currentVendor: VideoVendor | null;
+    /** Vendors the device can use, in cloud-declared order. */
+    readonly supportedVendors: readonly VideoVendor[];
+    /** True when the cloud picks the vendor dynamically at session time. */
+    readonly dynamicVendor: boolean;
+    /** Aliyun LinkVisual device id, when the device is on (or has been on) Aliyun. */
+    readonly iotId: string | null;
+    /** Whether the device is online. */
+    readonly online: boolean;
+}
+/**
+ * A device's TENCENT IoT triple, from `tx/mgr/dev/getIdentity`.
+ *
+ * Present only while the device is provisioned on the `tx` vendor. The secrets
+ * are session-scoped credentials for the Tencent IoT plane — never log them.
+ */
+interface TencentDeviceIdentity {
+    readonly productId: string;
+    readonly deviceName: string;
+    /** `<productId>/<deviceName>`, as the cloud composes it. */
+    readonly deviceId: string | null;
+    readonly secretId: string | null;
+    readonly secretKey: string | null;
+}
+/**
+ * The xp2p session descriptor from `tx/dev/getP2PInfo`.
+ *
+ * OPAQUE by nature: measured at 35 characters on an X50 and not JSON — it is
+ * the handle Tencent's proprietary xp2p SDK consumes to open the UDP P2P
+ * session, not a URL anything else can dial. It is carried, never parsed.
+ */
+interface TencentP2PDescriptor {
+    readonly p2pInfo: string;
+}
+
+/** What the device reports about its video SDK. */
+interface VideoVendorStatus {
+    readonly vendor: VideoVendor | null;
+    /** `1` once the SDK for {@link vendor} is up. A switch is not done until this. */
+    readonly initStatus: number | null;
+}
+
 /**
  * MIoT surface of the Dreame camera service (SIID 10001), reversed byte-exact
  * from the r2538z (X50) React-Native plugin `Monitor` model. Every camera
@@ -2076,6 +2151,39 @@ declare class VacuumDevice extends BaseDevice<VacuumDeviceEvents> {
         /** Reuse an existing relay minter (e.g. a shared {@link DreameVideoSession}). */
         relay?: RelayMinter;
     }): Promise<DreameCameraController>;
+    /**
+     * What video backend this robot is on, and whether that backend's SDK is up.
+     *
+     * A CACHED read by default: the cloud shadow answers for a robot on its dock
+     * without waking it, which is the whole point of asking before deciding how
+     * to stream. Pass `{ live: true }` when the answer must be current — while a
+     * switch settles, for instance.
+     */
+    readVideoVendorStatus(opts?: {
+        live?: boolean;
+    }): Promise<VideoVendorStatus>;
+    /**
+     * Move this robot onto a video backend, and WAIT until it is really there.
+     *
+     * The two backends are not interchangeable: measured on an X50 on
+     * 2026-09-16, a robot on `tx` offers only Tencent's proprietary UDP P2P
+     * plane (`getRtcInfo` answers 404), while the same robot on `ali` streams
+     * through a plain RTMP relay this library implements end to end. So which
+     * one it sits on decides whether it can be streamed at all.
+     *
+     * The device reports the NEW vendor before its SDK is up, which is why the
+     * app polls rather than trusting the action's return — and why this resolves
+     * on `initStatus === 1` and not a moment earlier. A half-switched robot
+     * answers questions about a backend it cannot yet serve.
+     *
+     * Only meaningful on a dual-vendor device (`videoDynamicVendor`, with the
+     * target in `defaultVendors`); a device that cannot move simply never
+     * settles, and this reports that as a timeout rather than a silent success.
+     */
+    setVideoVendor(vendor: VideoVendor, opts?: {
+        timeoutMs?: number;
+        pollIntervalMs?: number;
+    }): Promise<VideoVendorStatus>;
     /** Props worth seeding on start() / polling — exported for the facade. */
     static readonly DEFAULT_PROPS: readonly [{
         readonly siid: 2;
@@ -3050,50 +3158,6 @@ declare function createDumper(target: DumperDevice, options?: DumperOptions): Du
  */
 declare function createClientDumper(client: Nodreame, options?: DumperOptions): Dumper[];
 
-/**
- * Public types for the video control-plane. The Dreamehome cloud fronts several
- * camera backends ("vendors"); a device advertises which ones it supports and
- * which one it is currently provisioned on. This module models only the
- * control-plane (token + session negotiation); the media transport per vendor
- * is built on top of it.
- */
-/** Camera backend a device streams through. `tx` = Tencent, `ali` = Aliyun LinkVisual. */
-type VideoVendor = 'tx' | 'ali';
-/** Short-lived token minted by `tx/user/accesstoken`, used by the video endpoints. */
-interface VideoAccessToken {
-    /** Opaque bearer for the third-video service (distinct from the account token). */
-    readonly token: string;
-    /** Numeric video-service user id, as a string. */
-    readonly userId: string | null;
-    /** Epoch-ms at which {@link token} expires (converted from the cloud's epoch-seconds). */
-    readonly expiresAt: number;
-}
-/**
- * A device's video profile, derived from its cloud record. Tells you whether the
- * device has a camera, which vendors it supports, which one it is on now, and —
- * when on Aliyun — its LinkVisual `iotId` (the id every LinkVisual call needs).
- */
-interface DeviceVideoProfile {
-    /** Dreame device id (the `did`). */
-    readonly did: string;
-    /** Model code, e.g. `dreame.vacuum.r2538z`. */
-    readonly model: string;
-    /** Human product name, e.g. `X50 Ultra Complete`. */
-    readonly displayName: string | null;
-    /** True when the device exposes a camera stream (`permit === "video"`). */
-    readonly videoCapable: boolean;
-    /** The vendor the device is currently provisioned on (`''` in the record → null). */
-    readonly currentVendor: VideoVendor | null;
-    /** Vendors the device can use, in cloud-declared order. */
-    readonly supportedVendors: readonly VideoVendor[];
-    /** True when the cloud picks the vendor dynamically at session time. */
-    readonly dynamicVendor: boolean;
-    /** Aliyun LinkVisual device id, when the device is on (or has been on) Aliyun. */
-    readonly iotId: string | null;
-    /** Whether the device is online. */
-    readonly online: boolean;
-}
-
 /** Shared inputs for every video control-plane call. Mirrors `listDevices`. */
 interface VideoRequestInput {
     session: DreameSession;
@@ -3125,6 +3189,37 @@ declare function getAliyunAuthCode(input: VideoRequestInput): Promise<string>;
 declare function getVideoFamilyId(input: VideoRequestInput & {
     videoToken?: string;
 }): Promise<string>;
+/**
+ * The device's TENCENT IoT triple.
+ *
+ * Only meaningful while the device sits on the `tx` vendor: the cloud answers
+ * `设备三元组不存在` ("the triple does not exist") otherwise, which this
+ * surfaces as a thrown {@link DreameError} like any other refusal — a device on
+ * `ali` has no Tencent identity, and that is a statement about the device, not
+ * a failure of the call.
+ */
+declare function getTencentIdentity(input: VideoRequestInput & {
+    did: string;
+    videoToken?: string;
+}): Promise<TencentDeviceIdentity>;
+/**
+ * The xp2p session descriptor for a device on the `tx` vendor.
+ *
+ * ## This may WAKE THE CAMERA
+ *
+ * It is the Tencent equivalent of asking for a stream, so it is never called
+ * as part of a status read.
+ *
+ * The result is opaque (see {@link TencentP2PDescriptor}) and is useless
+ * without an xp2p implementation: measured on an X50 on 2026-09-16, the
+ * sibling `tx/dev/getRtcInfo` — the TRTC path, which WOULD be portable — answers
+ * 404 for this model. So the only media plane Tencent offers this device is the
+ * proprietary UDP P2P one.
+ */
+declare function getTencentP2PInfo(input: VideoRequestInput & {
+    did: string;
+    videoToken?: string;
+}): Promise<TencentP2PDescriptor>;
 /**
  * Resolve a device's video profile (vendor, supported vendors, Aliyun iotId,
  * capability) from its cloud record. `did` is the Dreame device id.
@@ -3746,4 +3841,4 @@ interface ListDevicesInput {
 /** Enumerate the devices visible to the authenticated account (incl. shared). */
 declare function listDevices(input: ListDevicesInput): Promise<DreameDevice[]>;
 
-export { AI_FEATURE_BIT, AI_FEATURE_JSON_KEY, ALIYUN_REGION_ID, AUTO_SWITCH_JSON_KEY, type AacConfig, type AiDetectionRaw, type AudioInfoEvent, type AutoSwitchKey, type AutoSwitchRaw, type AvcConfig, BaseDevice, type BaseDeviceEvents, type BatchDeviceDataFetcher, type BrokerEndpoint, type CameraStreamHandle, type CapabilityResolver, ChargingStatus, type CleanOpts, CleaningMode, type ConsumableReading, type ConsumableSpec, type CreateDeviceArgs, DRIVE_DIRECTIONS, DefaultCapabilityResolver, type DetectionBox, type DeviceCapabilities, type DeviceConnectivity, type DeviceDump, type DeviceEvent, type DeviceVideoProfile, type DreameAiFeature, DreameApiError, DreameAuthError, DreameCameraController, type DreameCameraControllerInput, DreameCameraStream, type DreameCameraStreamEvents, type DreameCameraStreamInput, type DreameCloudState, type DreameConsumableKey, type DreameDevice, DreameDeviceOfflineError, DreameError, type DreameRegion, type DreameSession, DreameTransportError, DreameVideoSession, type DreameVideoSessionInput, type DriveDirection, type DumperOptions, type FrameSource, type FrameSourceFactory, type IotSession, LIBRARY_NAME, LV_STATUS, type ListDevicesInput, LvRtmpClient, type LvRtmpClientOptions, MONITOR_AIID, MONITOR_PIID, MONITOR_SIID, MONITOR_VENDOR_TOKEN, MODEL_CAPABILITIES as MOWER_MODEL_CAPABILITIES, MOWER_TASK_SUBSTATES, type MapBoundingBox, type MapCleanedAreaOverlay, type MapColorScheme, type MapDimensions, type MapFrameType, type MapLayer, type MapLayerType, type MapLowLyingArea, type MapObstacle, type MapPath, type MapPathType, type MapPoint, type MapPose, type MapRestrictedArea, type MapRoom, type MapRoomWall, type MapRun, type MapSegment, type MapStorey, type MapVirtualWall, type MapWallsInfo, type MiotAction, MiotError, type MiotProp, MiotState, type MonitorActionCaller, type MowerAvailableMap, type MowerCapabilities, MowerCapabilityResolver, MowerChargingStatus, type MowerConsumableKey, type MowerConsumableReading, type MowerContour, MowerControlAction, type MowerControlState, MowerDevice, type MowerDeviceInput, MowerFault, type MowerFaultSeverity, type MowerHeartbeat, type MowerMap, type MowerMapBoundary, type MowerMowPath, type MowerMowingProgress, type MowerPathEntry, type MowerPoint, type MowerSpotArea, MowerStatus, type MowerTaskDescriptor, MowerTaskStatus, type MowerTaskSubState, type MowerZone, Nodreame, type NodreameDeps, type NodreameEvents, type NodreameOptions, type OaSession, type ObstacleDetection, type OssFetchInput, type OssFetcherLike, PET_SOUNDS, type PersonFollowDetection, type PetSound, type PropertyChangedEvent, type PropertyResult, type PropertyState, type PropertyWrite, type RelayMinter, type RenderMowerSvgOptions, type RenderVacuumPngOptions, type RenderWifiSignalPngOptions, type StateChangedEvent, type StatusEvent, type StreamInfo, type StreamQueryInput, SuctionLevel, TALK_AUDIO_HEADER_G711A, TaskStatus, VACUUM_ACTIONS, VACUUM_CONSUMABLES, MODEL_CAPABILITIES$1 as VACUUM_MODEL_CAPABILITIES, VACUUM_MOVE, VACUUM_SIID, type VacuumActionKey, type VacuumCapabilities, VacuumCapabilityResolver, VacuumDevice, type VacuumGetMapInput, type VacuumMap, type VideoAccessToken, type VideoAccessUnitEvent, type VideoRequestInput, type VideoVendor, WaterVolume, type WifiSignalMap, type WifiSignalMapInput, aacSampleRate, aacToAdts, avccToAnnexB, consumableSpec, createClientDumper, createDumper, createIotSession, decodeAiFeature, decodeAutoSwitch, decodeAutoSwitchAll, decodeWifiSignalMap, encodeAiFeatureWrite, encodeAutoSwitchWrite, explainNoCameraChannel, extractMowerConsumableValues, getAliyunAuthCode, getDeviceVideoProfile, getMowerCapabilities, getVacuumCapabilities, getVideoAccessToken, getVideoFamilyId, hashAccessCode, isAuthRefusedError, isDreameConsumableKey, listDevices, loginByOauth, makeMonitorSession, mowerConsumableIndex, mowerFaultSeverity, parseAacConfig, parseAvcConfig, parseConnectivity, parseMowerConsumables, parseMowerHeartbeat, parseMowingProgress, parseObstacleData, parsePersonFollow, parseRelayUrl, pcm16ToALaw, pcm16leToALaw, remoteDriveValue, renderMowerSvg, renderVacuumPng, renderWifiSignalPng, resolveCapabilities, signApiGatewayRequest, streamQuery, supportedAutoSwitchKeys, toVideoProfile };
+export { AI_FEATURE_BIT, AI_FEATURE_JSON_KEY, ALIYUN_REGION_ID, AUTO_SWITCH_JSON_KEY, type AacConfig, type AiDetectionRaw, type AudioInfoEvent, type AutoSwitchKey, type AutoSwitchRaw, type AvcConfig, BaseDevice, type BaseDeviceEvents, type BatchDeviceDataFetcher, type BrokerEndpoint, type CameraStreamHandle, type CapabilityResolver, ChargingStatus, type CleanOpts, CleaningMode, type ConsumableReading, type ConsumableSpec, type CreateDeviceArgs, DRIVE_DIRECTIONS, DefaultCapabilityResolver, type DetectionBox, type DeviceCapabilities, type DeviceConnectivity, type DeviceDump, type DeviceEvent, type DeviceVideoProfile, type DreameAiFeature, DreameApiError, DreameAuthError, DreameCameraController, type DreameCameraControllerInput, DreameCameraStream, type DreameCameraStreamEvents, type DreameCameraStreamInput, type DreameCloudState, type DreameConsumableKey, type DreameDevice, DreameDeviceOfflineError, DreameError, type DreameRegion, type DreameSession, DreameTransportError, DreameVideoSession, type DreameVideoSessionInput, type DriveDirection, type DumperOptions, type FrameSource, type FrameSourceFactory, type IotSession, LIBRARY_NAME, LV_STATUS, type ListDevicesInput, LvRtmpClient, type LvRtmpClientOptions, MONITOR_AIID, MONITOR_PIID, MONITOR_SIID, MONITOR_VENDOR_TOKEN, MODEL_CAPABILITIES as MOWER_MODEL_CAPABILITIES, MOWER_TASK_SUBSTATES, type MapBoundingBox, type MapCleanedAreaOverlay, type MapColorScheme, type MapDimensions, type MapFrameType, type MapLayer, type MapLayerType, type MapLowLyingArea, type MapObstacle, type MapPath, type MapPathType, type MapPoint, type MapPose, type MapRestrictedArea, type MapRoom, type MapRoomWall, type MapRun, type MapSegment, type MapStorey, type MapVirtualWall, type MapWallsInfo, type MiotAction, MiotError, type MiotProp, MiotState, type MonitorActionCaller, type MowerAvailableMap, type MowerCapabilities, MowerCapabilityResolver, MowerChargingStatus, type MowerConsumableKey, type MowerConsumableReading, type MowerContour, MowerControlAction, type MowerControlState, MowerDevice, type MowerDeviceInput, MowerFault, type MowerFaultSeverity, type MowerHeartbeat, type MowerMap, type MowerMapBoundary, type MowerMowPath, type MowerMowingProgress, type MowerPathEntry, type MowerPoint, type MowerSpotArea, MowerStatus, type MowerTaskDescriptor, MowerTaskStatus, type MowerTaskSubState, type MowerZone, Nodreame, type NodreameDeps, type NodreameEvents, type NodreameOptions, type OaSession, type ObstacleDetection, type OssFetchInput, type OssFetcherLike, PET_SOUNDS, type PersonFollowDetection, type PetSound, type PropertyChangedEvent, type PropertyResult, type PropertyState, type PropertyWrite, type RelayMinter, type RenderMowerSvgOptions, type RenderVacuumPngOptions, type RenderWifiSignalPngOptions, type StateChangedEvent, type StatusEvent, type StreamInfo, type StreamQueryInput, SuctionLevel, TALK_AUDIO_HEADER_G711A, TaskStatus, VACUUM_ACTIONS, VACUUM_CONSUMABLES, MODEL_CAPABILITIES$1 as VACUUM_MODEL_CAPABILITIES, VACUUM_MOVE, VACUUM_SIID, type VacuumActionKey, type VacuumCapabilities, VacuumCapabilityResolver, VacuumDevice, type VacuumGetMapInput, type VacuumMap, type VideoAccessToken, type VideoAccessUnitEvent, type VideoRequestInput, type VideoVendor, WaterVolume, type WifiSignalMap, type WifiSignalMapInput, aacSampleRate, aacToAdts, avccToAnnexB, consumableSpec, createClientDumper, createDumper, createIotSession, decodeAiFeature, decodeAutoSwitch, decodeAutoSwitchAll, decodeWifiSignalMap, encodeAiFeatureWrite, encodeAutoSwitchWrite, explainNoCameraChannel, extractMowerConsumableValues, getAliyunAuthCode, getDeviceVideoProfile, getMowerCapabilities, getTencentIdentity, getTencentP2PInfo, getVacuumCapabilities, getVideoAccessToken, getVideoFamilyId, hashAccessCode, isAuthRefusedError, isDreameConsumableKey, listDevices, loginByOauth, makeMonitorSession, mowerConsumableIndex, mowerFaultSeverity, parseAacConfig, parseAvcConfig, parseConnectivity, parseMowerConsumables, parseMowerHeartbeat, parseMowingProgress, parseObstacleData, parsePersonFollow, parseRelayUrl, pcm16ToALaw, pcm16leToALaw, remoteDriveValue, renderMowerSvg, renderVacuumPng, renderWifiSignalPng, resolveCapabilities, signApiGatewayRequest, streamQuery, supportedAutoSwitchKeys, toVideoProfile };

package/dist/index.js

@@ -1,6 +1,6 @@
 // src/support/version.ts
 var LIBRARY_NAME = "nodedreame";
-var LIBRARY_VERSION = "1.12.2";
+var LIBRARY_VERSION = "1.12.4";
 
 // src/transport/errors.ts
 var DreameError = class extends Error {
@@ -2066,6 +2066,24 @@ var FamilyIdResponseSchema = z3.object({
   msg: z3.string().nullish(),
   data: z3.object({ data: z3.object({ familyId: z3.string() }).passthrough() }).passthrough()
 }).passthrough();
+var TencentIdentityResponseSchema = z3.object({
+  code: z3.number().optional(),
+  msg: z3.string().nullish(),
+  data: z3.object({
+    data: z3.object({
+      productId: z3.string(),
+      deviceName: z3.string(),
+      deviceId: z3.string().optional(),
+      secretId: z3.string().optional(),
+      secretKey: z3.string().optional()
+    }).passthrough()
+  }).passthrough()
+}).passthrough();
+var TencentP2PInfoResponseSchema = z3.object({
+  code: z3.number().optional(),
+  msg: z3.string().nullish(),
+  data: z3.object({ data: z3.object({ p2pInfo: z3.string() }).passthrough() }).passthrough()
+}).passthrough();
 var DeviceVideoInfoSchema = z3.object({
   model: z3.string().optional(),
   displayName: z3.string().optional(),
@@ -2186,6 +2204,37 @@ async function getVideoFamilyId(input) {
   });
   return FamilyIdResponseSchema.parse(raw).data.data.familyId;
 }
+async function getTencentIdentity(input) {
+  const ctx = resolveCtx(input);
+  const videoToken = input.videoToken ?? (await getVideoAccessToken({ ...input, ctx })).token;
+  const raw = await httpPostJsonBody({
+    ctx,
+    path: `${P_THIRD_VIDEO}/tx/mgr/dev/getIdentity`,
+    body: { accesstoken: videoToken, os: DEFAULT_OS, did: input.did },
+    context: "tencent identity",
+    ...passthrough(input)
+  });
+  const d = TencentIdentityResponseSchema.parse(raw).data.data;
+  return {
+    productId: d.productId,
+    deviceName: d.deviceName,
+    deviceId: d.deviceId ?? null,
+    secretId: d.secretId ?? null,
+    secretKey: d.secretKey ?? null
+  };
+}
+async function getTencentP2PInfo(input) {
+  const ctx = resolveCtx(input);
+  const videoToken = input.videoToken ?? (await getVideoAccessToken({ ...input, ctx })).token;
+  const raw = await httpPostJsonBody({
+    ctx,
+    path: `${P_THIRD_VIDEO}/tx/dev/getP2PInfo`,
+    body: { accesstoken: videoToken, os: DEFAULT_OS, did: input.did },
+    context: "tencent p2p info",
+    ...passthrough(input)
+  });
+  return { p2pInfo: TencentP2PInfoResponseSchema.parse(raw).data.data.p2pInfo };
+}
 async function getDeviceVideoProfile(input) {
   const ctx = resolveCtx(input);
   const raw = await httpPostJsonBody({
@@ -2778,6 +2827,34 @@ function firstOutValue(res) {
   return Array.isArray(out) && out.length > 0 ? out[0]?.value : void 0;
 }
 
+// src/video/monitor/vendor.ts
+function videoVendorSwitchParams(vendor) {
+  return { vendor };
+}
+function parseVideoVendorStatus(raw) {
+  const text = typeof raw === "string" ? raw : typeof raw === "object" && raw !== null ? null : null;
+  const source = text === null ? raw : safeJson(text);
+  if (typeof source !== "object" || source === null) {
+    return { vendor: null, initStatus: null };
+  }
+  const v = Reflect.get(source, "vendor");
+  const s = Reflect.get(source, "initStatus");
+  return {
+    vendor: v === "ali" || v === "tx" ? v : null,
+    initStatus: typeof s === "number" ? s : null
+  };
+}
+function safeJson(text) {
+  try {
+    return JSON.parse(text);
+  } catch {
+    return null;
+  }
+}
+function vendorSwitchSettled(status, wanted) {
+  return status.vendor === wanted && status.initStatus === 1;
+}
+
 // src/video/monitor/controller.ts
 var DEFAULT_KEEP_ALIVE_MS = 1e4;
 var DEFAULT_AREA = "4";
@@ -5358,6 +5435,60 @@ var VacuumDevice = class _VacuumDevice extends BaseDevice {
       ...opts?.log ? { log: opts.log } : {}
     });
   }
+  /**
+   * What video backend this robot is on, and whether that backend's SDK is up.
+   *
+   * A CACHED read by default: the cloud shadow answers for a robot on its dock
+   * without waking it, which is the whole point of asking before deciding how
+   * to stream. Pass `{ live: true }` when the answer must be current — while a
+   * switch settles, for instance.
+   */
+  async readVideoVendorStatus(opts) {
+    const props = [{ siid: MONITOR_SIID, piid: MONITOR_PIID.VIDEO_VENDOR_STATUS }];
+    const results = opts?.live === true ? await this.refreshProperties(props) : await this.refreshCachedProperties(props);
+    return parseVideoVendorStatus(results[0]?.value);
+  }
+  /**
+   * Move this robot onto a video backend, and WAIT until it is really there.
+   *
+   * The two backends are not interchangeable: measured on an X50 on
+   * 2026-09-16, a robot on `tx` offers only Tencent's proprietary UDP P2P
+   * plane (`getRtcInfo` answers 404), while the same robot on `ali` streams
+   * through a plain RTMP relay this library implements end to end. So which
+   * one it sits on decides whether it can be streamed at all.
+   *
+   * The device reports the NEW vendor before its SDK is up, which is why the
+   * app polls rather than trusting the action's return — and why this resolves
+   * on `initStatus === 1` and not a moment earlier. A half-switched robot
+   * answers questions about a backend it cannot yet serve.
+   *
+   * Only meaningful on a dual-vendor device (`videoDynamicVendor`, with the
+   * target in `defaultVendors`); a device that cannot move simply never
+   * settles, and this reports that as a timeout rather than a silent success.
+   */
+  async setVideoVendor(vendor, opts) {
+    const already = await this.readVideoVendorStatus({ live: true });
+    if (vendorSwitchSettled(already, vendor)) {
+      return already;
+    }
+    const session = makeMonitorSession(this.currentSession().uid);
+    await this.callAction(MONITOR_SIID, MONITOR_AIID.VIDEO_VENDOR, [
+      buildActionInput(MONITOR_PIID.VIDEO_VENDOR_STATUS, videoVendorSwitchParams(vendor), session)
+    ]);
+    const every = opts?.pollIntervalMs ?? 5e3;
+    const deadline = Date.now() + (opts?.timeoutMs ?? every * 10);
+    let last = already;
+    while (Date.now() < deadline) {
+      await new Promise((r) => setTimeout(r, every));
+      last = await this.readVideoVendorStatus({ live: true });
+      if (vendorSwitchSettled(last, vendor)) {
+        return last;
+      }
+    }
+    throw new DreameError(
+      `video vendor did not settle on "${vendor}" within the timeout (last seen: vendor=${last.vendor ?? "unknown"}, initStatus=${String(last.initStatus)})`
+    );
+  }
   /** Props worth seeding on start() / polling — exported for the facade. */
   static DEFAULT_PROPS = [
     VACUUM_PROP.STATE,
@@ -8439,6 +8570,8 @@ export {
   getAliyunAuthCode,
   getDeviceVideoProfile,
   getMowerCapabilities,
+  getTencentIdentity,
+  getTencentP2PInfo,
   getVacuumCapabilities,
   getVideoAccessToken,
   getVideoFamilyId,