@apocaliss92/nodedreame 1.1.0 → 1.3.0

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import { fetch } from 'undici';
+import { z } from 'zod';
 
 /** Public name of this library. */
 declare const LIBRARY_NAME = "nodedreame";
@@ -466,11 +467,27 @@ declare enum MiotState {
     ReturnToEmpty = 28,
     WaitingForTask = 29,
     CleanWashboardBase = 30,
+    ReturningToDrain = 31,
+    Draining = 32,
     AutoWaterDraining = 33,
+    Emptying = 34,
+    DustBagDrying = 35,
+    DustBagDryingPaused = 36,
+    HeadingToExtraCleaning = 37,
+    ExtraCleaning = 38,
+    FindingPetPaused = 95,
+    FindingPet = 96,
     ShortcutRunning = 97,
     CameraMonitoring = 98,
     CameraMonitoringPaused = 99,
-    InitialDeepClean = 101
+    InitialDeepClean = 101,
+    InitialDeepCleanPaused = 102,
+    Sanitizing = 103,
+    SanitizingWithDry = 104,
+    ChangingMop = 105,
+    ChangingMopPaused = 106,
+    FloorMaintaining = 107,
+    FloorMaintainingPaused = 108
 }
 /** VERIFIED on r2532a 2026-05-02 — ChargingStatus (siid 3 piid 2). */
 declare enum ChargingStatus {
@@ -505,27 +522,97 @@ declare enum CleaningMode {
 }
 /**
  * Error / fault value space for ERROR (siid 2 piid 2) and FAULTS_STR
- * (siid 4 piid 18). VERIFIED members confirmed live on r2532a; the rest are
- * ASSUMED from Tasshack types.py — the integer is the source of truth.
+ * (siid 4 piid 18). This is the FULL Tasshack `DreameVacuumErrorCode` table
+ * (types.py) — every documented integer is mapped. Members whose names were
+ * VERIFIED live on r2532a keep their verified labels even where the donor uses
+ * a different label for the same integer (annotated inline); the rest carry the
+ * donor's documented name. UNKNOWN (-1) is intentionally omitted — an unknown
+ * code falls through the cast-free lookup and surfaces as the raw number.
  */
 declare enum MiotError {
-    Clear = 0,
-    WheelRotationAnomaly = 1,
-    RobotLifted = 18,
-    TaskComplete = 68,
-    ManualMopInstallRequired = 74,
-    WastewaterTankFull = 105,
-    CleanWaterTankEmpty = 107,
-    WashboardFilterNeedsCleaning = 114,
-    MopPadsMissing = 120,
+    Clear = 0,// donor NO_ERROR
+    WheelRotationAnomaly = 1,// donor DROP (VERIFIED label kept)
+    Cliff = 2,
+    Bumper = 3,
+    Gesture = 4,
+    BumperRepeat = 5,
+    DropRepeat = 6,
+    OpticalFlow = 7,
+    Box = 8,
+    TankBox = 9,
+    WaterBoxEmpty = 10,
+    BoxFull = 11,
+    Brush = 12,
+    SideBrush = 13,
+    Fan = 14,
+    LeftWheelMotor = 15,
+    RightWheelMotor = 16,
+    TurnSuffocate = 17,
+    RobotLifted = 18,// donor FORWARD_SUFFOCATE (VERIFIED label kept)
+    ChargerGet = 19,
     BatteryLow = 20,
     ChargeFault = 21,
-    BatteryPercentageAnomaly = 22,
+    BatteryPercentageAnomaly = 22,// donor BATTERY_PERCENTAGE
+    Heart = 23,
+    CameraOcclusion = 24,
+    Move = 25,
+    FlowShielding = 26,
+    InfraredShielding = 27,
     ChargeNoElectric = 28,
     BatteryFault = 29,
+    FanSpeedError = 30,
+    LeftWheelSpeed = 31,
+    RightWheelSpeed = 32,
+    Bmi055Acce = 33,
+    Bmi055Gyro = 34,
+    Xv7001 = 35,
+    LeftMagnet = 36,
+    RightMagnet = 37,
+    FlowError = 38,
+    InfraredFault = 39,
+    CameraFault = 40,
+    StrongMagnet = 41,
+    WaterPump = 42,
+    Rtc = 43,
+    AutoKeyTrig = 44,
+    P3v3 = 45,
+    CameraIdle = 46,
+    Blocked = 47,
+    LdsError = 48,
+    LdsBumper = 49,
+    WaterPump2 = 50,
+    FilterBlocked = 51,
+    Edge = 54,
+    Carpet = 55,
+    Laser = 56,
+    Edge2 = 57,
+    Ultrasonic = 58,
+    NoGoZone = 59,
+    Route = 61,
+    Route2 = 62,
+    Blocked2 = 63,
+    Blocked3 = 64,
+    Restricted = 65,
+    Restricted2 = 66,
+    Restricted3 = 67,
+    TaskComplete = 68,// donor REMOVE_MOP (VERIFIED label kept)
+    MopRemoved = 69,
+    MopRemoved2 = 70,
+    MopPadStopRotate = 71,
+    MopPadStopRotate2 = 72,
+    ManualMopInstallRequired = 74,// donor MOP_INSTALL_FAILED (VERIFIED label kept)
     LowBatteryTurnOff = 75,
+    DirtyTankNotInstalled = 76,
+    RobotInHiddenRoom = 78,
+    LdsFailedToLift = 79,
     RobotStuck = 80,
     RobotStuckRepeat = 81,
+    SlipperyFloor = 82,
+    UnknownError = 84,
+    CheckMopInstall = 85,
+    DirtyWaterTankFull = 86,
+    RetractableLegStuck = 88,
+    InternalError = 89,
     RobotStuck2 = 90,
     RobotStuckOnTables = 91,
     RobotStuckOnPassage = 92,
@@ -536,19 +623,91 @@ declare enum MiotError {
     RobotStuckOnPet = 97,
     RobotStuckOnSlipperySurface = 98,
     RobotStuckOnCarpet = 99,
-    RobotStuckOnCurtain = 200,
     BinFull = 101,
+    BinOpen = 102,
+    BinOpen2 = 103,
+    BinFull2 = 104,
+    WastewaterTankFull = 105,// donor WATER_TANK (VERIFIED label kept)
+    DirtyWaterTank = 106,
+    CleanWaterTankEmpty = 107,// donor WATER_TANK_DRY (VERIFIED label kept)
+    DirtyWaterTank2 = 108,
+    DirtyWaterTankBlocked = 109,
+    DirtyWaterTankPump = 110,
+    MopPad = 111,
+    WetMopPad = 112,
+    WashboardFilterNeedsCleaning = 114,// donor CLEAN_MOP_PAD (VERIFIED label kept)
+    CleanTankLevel = 116,
     StationDisconnected = 117,
-    DustBagFull = 121
+    DirtyTankLevel = 118,
+    WashboardLevel = 119,
+    MopPadsMissing = 120,// donor NO_MOP_IN_STATION (VERIFIED label kept)
+    DustBagFull = 121,
+    UnknownWarning = 122,
+    SelfTestFailed = 123,
+    WashboardNotWorking = 124,
+    DrainageFailed = 125,
+    MopNotDetected = 126,
+    MopHolderError = 127,
+    DockError = 128,
+    WashFailed = 129,
+    RobotStuckOnCurtain = 200,
+    EdgeMopStopRotate = 201,
+    EdgeMopDetached = 202,
+    ChassisLiftMalfunction = 203,
+    InternalError2 = 207,
+    MopCoverError = 209,
+    RollerMopError = 210,
+    OnboardWaterTankEmpty = 213,
+    OnboardDirtyWaterTankFull = 214,
+    MopNotInstalled = 215,
+    RollerMopError2 = 218,
+    FluffingRollerError = 222,
+    MopCoverError2 = 223,
+    BlockedByObstacle = 226,
+    ReturnToChargeFailed = 1000
 }
-/** VERIFIED on r2532a 2026-05-02 — TASK_STATUS (siid 4 piid 1). */
+/**
+ * TASK_STATUS (siid 4 piid 1). Codes 1/2/3/6/12/14 carry the labels VERIFIED
+ * live on r2532a 2026-05-02 — these are KEPT verbatim because they were
+ * observed against real task transitions and differ from the donor's labels for
+ * the same integers (donor: 1=AUTO_CLEANING, 2=ZONE_CLEANING, 3=SEGMENT_CLEANING,
+ * 6=AUTO_CLEANING_PAUSED, 12=MOPPING_PAUSED, 14=ZONE_MOPPING_PAUSED). The
+ * remaining members are ASSUMED from Tasshack `DreameVacuumTaskStatus`
+ * (types.py) — added so documented codes resolve to a name. Unknown codes
+ * surface as raw via {@link VacuumDevice.taskStatusRaw}.
+ */
 declare enum TaskStatus {
+    Completed = 0,
     InterruptedOrPaused = 1,
     Active = 2,
     Transitioning = 3,
+    SpotCleaning = 4,
+    FastMapping = 5,
     OnDockIdle = 6,
+    ZoneCleaningPaused = 7,
+    SegmentCleaningPaused = 8,
+    SpotCleaningPaused = 9,
+    MapCleaningPaused = 10,
+    DockingPaused = 11,
     TransientPauseEdge = 12,
-    NeedsIntervention = 14
+    SegmentMoppingPaused = 13,
+    NeedsIntervention = 14,
+    AutoMoppingPaused = 15,
+    AutoDockingPaused = 16,
+    SegmentDockingPaused = 17,
+    ZoneDockingPaused = 18,
+    CruisingPath = 20,
+    CruisingPathPaused = 21,
+    CruisingPoint = 22,
+    CruisingPointPaused = 23,
+    SummonCleanPaused = 24,
+    ReturningInstallMop = 25,
+    ReturningRemoveMop = 26,
+    StationCleaning = 27,
+    PetFinding = 30,
+    AutoCleaningWashingPaused = 31,
+    AreaCleaningWashingPaused = 32,
+    CustomCleaningWashingPaused = 33
 }
 
 /**
@@ -1024,6 +1183,14 @@ declare class VacuumDevice extends BaseDevice<VacuumDeviceEvents> {
     constructor(input: BaseDeviceInput);
     /** Rich, vacuum-specific capability record (booleans + supported enums). */
     get vacuumCapabilities(): VacuumCapabilities;
+    /**
+     * The suction levels this model supports, as a {@link SuctionLevel} enum array
+     * (from the capability record). Lets a consumer see which fan speeds are
+     * selectable without reaching into {@link vacuumCapabilities}.
+     */
+    get supportedSuctionLevels(): readonly SuctionLevel[];
+    /** The water/mop volumes this model supports, as a {@link WaterVolume} enum array. */
+    get supportedWaterVolumes(): readonly WaterVolume[];
     get statusRaw(): number | null;
     get status(): MiotState | null;
     get battery(): number | null;
@@ -1215,13 +1382,104 @@ declare enum MowerControlAction {
 }
 /**
  * Observed TASK_STATUS codes (siid 5 piid 104), service5.py TASK_STATUS_MAPPING.
- * Only `SpotIncomplete` (7) has a confirmed meaning; the others in the donor are
- * "Unknown task status: N" — ASSUMED / not exposed as named members here.
+ * Only `SpotIncomplete` (7) has a confirmed meaning; the donor explicitly marks
+ * codes 2/3/10/13 as "Unknown task status: N" (observed after RAIN/LOST/
+ * LOW_BATTERY events). Those are NOT invented as named members — they surface as
+ * raw via {@link MowerDevice.taskStatusRaw}. This is the FULL documented set:
+ * the donor names exactly one code.
  */
 declare enum MowerTaskStatus {
     /** "Task incomplete - spot mowing". */
     SpotIncomplete = 7
 }
+/**
+ * Mower device-code / fault value space for DEVICE_CODE (siid 2 piid 2). This is
+ * the FULL donor `BASE_DEVICE_CODES` registry (property/device_code.py), codes
+ * 0..73 contiguous. Each integer is documented by the donor with a name +
+ * severity (INFO / WARNING / ERROR — noted inline). 0 = NO_DEVICE_CODE (normal
+ * operation). Codes not in this table (model-specific extensions) fall through
+ * the cast-free lookup and surface as raw via {@link MowerDevice.faultRaw}.
+ *
+ * Two donor names repeat at different integers; the second occurrence is
+ * suffixed (`LidarDirtyWarning` 38, `BatteryOverheatWarning` 42) to keep enum
+ * member names unique while preserving the integer source of truth.
+ */
+declare enum MowerFault {
+    NoDeviceCode = 0,// INFO
+    Tilted = 1,// ERROR
+    Trapped = 2,// ERROR
+    NarrowPathToStation = 3,// ERROR
+    LeftWheel = 4,// ERROR
+    RightWheel = 5,// ERROR
+    LiftMotor = 6,// ERROR
+    Cutter = 7,// ERROR
+    SidedMotor = 8,// ERROR
+    CrashPlate = 9,// ERROR
+    Charging = 10,// ERROR
+    BatteryOverheat = 11,// ERROR
+    LidarCovered = 12,// ERROR
+    LidarOverheatWithoutMap = 13,// ERROR
+    LidarOverheatWithMap = 14,// ERROR
+    LidarOverheat = 15,// ERROR
+    LidarDirty = 16,// ERROR
+    LidarAbnormal = 17,// ERROR
+    LocationWeak = 18,// ERROR
+    LocationLost = 19,// ERROR
+    Sensor = 20,// ERROR
+    InForbiddenArea = 21,// ERROR
+    OutOfMap = 22,// ERROR
+    EmergencyStop = 23,// ERROR
+    BatteryLow = 24,// ERROR
+    MapFileCrack = 25,// ERROR
+    AwayFromMap = 26,// ERROR
+    HumanDetected = 27,// ERROR
+    BladeLoss = 28,// ERROR
+    StationLoss = 29,// ERROR
+    MaintainLoss = 30,// ERROR
+    BackChargeFailed = 31,// WARNING
+    DockingFailed = 32,// WARNING
+    LocatingFailedWithMap = 33,// WARNING
+    LocatingFailedWithoutMap = 34,// WARNING
+    LocatingAbnormal = 35,// WARNING
+    TaskStartFailed = 36,// WARNING
+    PathImpassable = 37,// ERROR
+    LidarDirtyWarning = 38,// WARNING (donor LIDAR_DIRTY at 38)
+    CamDirty = 39,// WARNING
+    CamAbnormal = 40,// WARNING
+    CamCover = 41,// WARNING
+    BatteryOverheatWarning = 42,// WARNING (donor BATTERY_OVERHEAT at 42)
+    BatteryTempLow = 43,// WARNING
+    AutobuildBorder = 44,// WARNING
+    AutobuildSide = 45,// WARNING
+    BorderFinish = 46,// INFO
+    NewMap = 47,// INFO
+    TaskFinish = 48,// INFO
+    DestinationNotReachable = 49,// INFO
+    TaskStart = 50,// INFO
+    CruiseStart = 51,// INFO
+    PointAndGoStart = 52,// INFO
+    ScheduleStart = 53,// INFO
+    BatteryLowReturning = 54,// INFO
+    BatteryLowScheduleSuspend = 55,// INFO
+    BadWeatherProtecting = 56,// INFO
+    RainScheduleInterupted = 57,// INFO
+    RainScheduleSuspend = 58,// INFO
+    ForzenReturning = 59,// INFO
+    FrozenScheduleSuspend = 60,// INFO
+    NotDisturbReturning = 61,// INFO
+    NotDisturbScheduleSuspend = 62,// INFO
+    WorkingScheduleSuspend = 63,// INFO
+    RemoteControlingScheduleSuspend = 64,// INFO
+    EmergencyStoppedScheduleSuspend = 65,// INFO
+    TopCoverOpenScheduleSuspend = 66,// INFO
+    FaultModeScheduleSuspend = 67,// INFO
+    ScheduleTimeout = 68,// INFO
+    StationNotConnectedToWorkingArea = 69,// INFO
+    ContinueFromBreakpoint = 70,// INFO
+    IdleTimeoutReturning = 71,// INFO
+    PauseTimeoutReturning = 72,// INFO
+    TopCoverOpen = 73
+}
 
 /**
  * Cast-free mower decoders. Re-exports the shared numeric primitives, and adds
@@ -1440,6 +1698,19 @@ declare class MowerDevice extends BaseDevice {
     get isDocked(): boolean;
     get isMowing(): boolean;
     get taskStatusRaw(): number | null;
+    /**
+     * TASK_STATUS (5:104) decoded to {@link MowerTaskStatus}, or null. The donor
+     * names only code 7 (SpotIncomplete); codes 2/3/10/13 are documented "Unknown
+     * task status" and intentionally surface as raw via {@link taskStatusRaw}.
+     */
+    get taskStatus(): MowerTaskStatus | null;
+    get faultRaw(): number | null;
+    /**
+     * DEVICE_CODE (2:2) decoded to a {@link MowerFault} (the donor's
+     * BASE_DEVICE_CODES registry, 0..73), or null for a model-specific/undocumented
+     * code — which still surfaces as the raw number via {@link faultRaw}.
+     */
+    get fault(): MowerFault | null;
     /** Parsed scheduling task descriptor (2:50), or null. */
     get task(): MowerTaskDescriptor | null;
     /**
@@ -1503,6 +1774,9 @@ declare class MowerDevice extends BaseDevice {
     static readonly DEFAULT_PROPS: readonly [{
         readonly siid: 2;
         readonly piid: 1;
+    }, {
+        readonly siid: 2;
+        readonly piid: 2;
     }, {
         readonly siid: 3;
         readonly piid: 1;
@@ -1521,4 +1795,339 @@ declare class MowerDevice extends BaseDevice {
     }];
 }
 
-export { BaseDevice, type BaseDeviceEvents, type BatchDeviceDataFetcher, type CapabilityResolver, ChargingStatus, type CleanOpts, CleaningMode, type CreateDeviceArgs, DefaultCapabilityResolver, type DeviceCapabilities, type DeviceEvent, DreameApiError, DreameAuthError, type DreameCloudState, type DreameDevice, DreameDeviceOfflineError, DreameError, type DreameRegion, type DreameSession, DreameTransportError, LIBRARY_NAME, MODEL_CAPABILITIES as MOWER_MODEL_CAPABILITIES, type MapBoundingBox, type MapCleanedAreaOverlay, 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 MowerAvailableMap, type MowerCapabilities, MowerCapabilityResolver, MowerChargingStatus, type MowerContour, MowerControlAction, type MowerControlState, MowerDevice, type MowerDeviceInput, type MowerMap, type MowerMapBoundary, type MowerMowPath, type MowerPathEntry, type MowerPoint, type MowerSpotArea, MowerStatus, type MowerTaskDescriptor, MowerTaskStatus, type MowerZone, Nodreame, type NodreameDeps, type NodreameEvents, type NodreameOptions, type OssFetchInput, type OssFetcherLike, type PropertyChangedEvent, type PropertyResult, type PropertyState, type PropertyWrite, type RenderMowerSvgOptions, type RenderVacuumPngOptions, type StateChangedEvent, SuctionLevel, TaskStatus, MODEL_CAPABILITIES$1 as VACUUM_MODEL_CAPABILITIES, type VacuumCapabilities, VacuumCapabilityResolver, VacuumDevice, type VacuumGetMapInput, type VacuumMap, WaterVolume, getMowerCapabilities, getVacuumCapabilities, renderMowerSvg, renderVacuumPng, resolveCapabilities };
+declare const DeviceDumpSchema: z.ZodObject<{
+    schemaVersion: z.ZodLiteral<1>;
+    library: z.ZodUnion<[z.ZodLiteral<"nodedreame">, z.ZodLiteral<"nodewitt">]>;
+    libraryVersion: z.ZodString;
+    device: z.ZodObject<{
+        model: z.ZodString;
+        firmware: z.ZodOptional<z.ZodString>;
+        region: z.ZodOptional<z.ZodString>;
+        type: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        model: string;
+        type?: string | undefined;
+        region?: string | undefined;
+        firmware?: string | undefined;
+    }, {
+        model: string;
+        type?: string | undefined;
+        region?: string | undefined;
+        firmware?: string | undefined;
+    }>;
+    observations: z.ZodObject<{
+        properties: z.ZodRecord<z.ZodString, z.ZodObject<{
+            values: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>, "many">;
+            unmapped: z.ZodArray<z.ZodUnion<[z.ZodString, z.ZodNumber, z.ZodBoolean]>, "many">;
+            enum: z.ZodOptional<z.ZodString>;
+            count: z.ZodNumber;
+            firstSeen: z.ZodNumber;
+            lastSeen: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            values: (string | number | boolean)[];
+            unmapped: (string | number | boolean)[];
+            count: number;
+            firstSeen: number;
+            lastSeen: number;
+            enum?: string | undefined;
+        }, {
+            values: (string | number | boolean)[];
+            unmapped: (string | number | boolean)[];
+            count: number;
+            firstSeen: number;
+            lastSeen: number;
+            enum?: string | undefined;
+        }>>;
+        events: z.ZodArray<z.ZodObject<{
+            at: z.ZodNumber;
+            type: z.ZodString;
+            data: z.ZodOptional<z.ZodUnknown>;
+        }, "strip", z.ZodTypeAny, {
+            at: number;
+            type: string;
+            data?: unknown;
+        }, {
+            at: number;
+            type: string;
+            data?: unknown;
+        }>, "many">;
+        rawFrames: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            at: z.ZodNumber;
+            source: z.ZodString;
+            payload: z.ZodUnknown;
+        }, "strip", z.ZodTypeAny, {
+            at: number;
+            source: string;
+            payload?: unknown;
+        }, {
+            at: number;
+            source: string;
+            payload?: unknown;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        properties: Record<string, {
+            values: (string | number | boolean)[];
+            unmapped: (string | number | boolean)[];
+            count: number;
+            firstSeen: number;
+            lastSeen: number;
+            enum?: string | undefined;
+        }>;
+        events: {
+            at: number;
+            type: string;
+            data?: unknown;
+        }[];
+        rawFrames?: {
+            at: number;
+            source: string;
+            payload?: unknown;
+        }[] | undefined;
+    }, {
+        properties: Record<string, {
+            values: (string | number | boolean)[];
+            unmapped: (string | number | boolean)[];
+            count: number;
+            firstSeen: number;
+            lastSeen: number;
+            enum?: string | undefined;
+        }>;
+        events: {
+            at: number;
+            type: string;
+            data?: unknown;
+        }[];
+        rawFrames?: {
+            at: number;
+            source: string;
+            payload?: unknown;
+        }[] | undefined;
+    }>;
+    catalog: z.ZodObject<{
+        commands: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            siid: z.ZodOptional<z.ZodNumber>;
+            aiid: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            siid?: number | undefined;
+            aiid?: number | undefined;
+        }, {
+            name: string;
+            siid?: number | undefined;
+            aiid?: number | undefined;
+        }>, "many">>;
+        capabilities: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        sensors: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            model: z.ZodString;
+            channel: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            model: string;
+            channel?: number | undefined;
+        }, {
+            model: string;
+            channel?: number | undefined;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        commands?: {
+            name: string;
+            siid?: number | undefined;
+            aiid?: number | undefined;
+        }[] | undefined;
+        capabilities?: Record<string, unknown> | undefined;
+        sensors?: {
+            model: string;
+            channel?: number | undefined;
+        }[] | undefined;
+    }, {
+        commands?: {
+            name: string;
+            siid?: number | undefined;
+            aiid?: number | undefined;
+        }[] | undefined;
+        capabilities?: Record<string, unknown> | undefined;
+        sensors?: {
+            model: string;
+            channel?: number | undefined;
+        }[] | undefined;
+    }>;
+    meta: z.ZodObject<{
+        startedAt: z.ZodNumber;
+        durationMs: z.ZodNumber;
+        generatedAt: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        startedAt: number;
+        durationMs: number;
+        generatedAt: number;
+    }, {
+        startedAt: number;
+        durationMs: number;
+        generatedAt: number;
+    }>;
+}, "strip", z.ZodTypeAny, {
+    schemaVersion: 1;
+    library: "nodedreame" | "nodewitt";
+    libraryVersion: string;
+    device: {
+        model: string;
+        type?: string | undefined;
+        region?: string | undefined;
+        firmware?: string | undefined;
+    };
+    observations: {
+        properties: Record<string, {
+            values: (string | number | boolean)[];
+            unmapped: (string | number | boolean)[];
+            count: number;
+            firstSeen: number;
+            lastSeen: number;
+            enum?: string | undefined;
+        }>;
+        events: {
+            at: number;
+            type: string;
+            data?: unknown;
+        }[];
+        rawFrames?: {
+            at: number;
+            source: string;
+            payload?: unknown;
+        }[] | undefined;
+    };
+    catalog: {
+        commands?: {
+            name: string;
+            siid?: number | undefined;
+            aiid?: number | undefined;
+        }[] | undefined;
+        capabilities?: Record<string, unknown> | undefined;
+        sensors?: {
+            model: string;
+            channel?: number | undefined;
+        }[] | undefined;
+    };
+    meta: {
+        startedAt: number;
+        durationMs: number;
+        generatedAt: number;
+    };
+}, {
+    schemaVersion: 1;
+    library: "nodedreame" | "nodewitt";
+    libraryVersion: string;
+    device: {
+        model: string;
+        type?: string | undefined;
+        region?: string | undefined;
+        firmware?: string | undefined;
+    };
+    observations: {
+        properties: Record<string, {
+            values: (string | number | boolean)[];
+            unmapped: (string | number | boolean)[];
+            count: number;
+            firstSeen: number;
+            lastSeen: number;
+            enum?: string | undefined;
+        }>;
+        events: {
+            at: number;
+            type: string;
+            data?: unknown;
+        }[];
+        rawFrames?: {
+            at: number;
+            source: string;
+            payload?: unknown;
+        }[] | undefined;
+    };
+    catalog: {
+        commands?: {
+            name: string;
+            siid?: number | undefined;
+            aiid?: number | undefined;
+        }[] | undefined;
+        capabilities?: Record<string, unknown> | undefined;
+        sensors?: {
+            model: string;
+            channel?: number | undefined;
+        }[] | undefined;
+    };
+    meta: {
+        startedAt: number;
+        durationMs: number;
+        generatedAt: number;
+    };
+}>;
+/** Public shared dump type — inferred from the schema so the two never drift. */
+type DeviceDump = z.infer<typeof DeviceDumpSchema>;
+
+/** A property decoder: the enum NAME + a membership test for a raw number. */
+interface KeyDecoder {
+    enumName: string;
+    isMember(raw: number): boolean;
+}
+/** Tunables for a {@link Dumper}. All optional. */
+interface DumperOptions {
+    /** Capture raw event/property frames into `observations.rawFrames`. Default false. */
+    captureRawFrames?: boolean;
+    /** Cap on retained raw frames (ring). Default 500. */
+    maxRawFrames?: number;
+    /** Periodic cloud-shadow refresh interval (ms). Default 30000; 0 disables. */
+    refreshIntervalMs?: number;
+}
+/**
+ * The READ-ONLY slice of a device the {@link Dumper} consumes. Declaring it as
+ * an interface lets tests inject a fake with no cast (mirrors `PushLike`). A real
+ * `BaseDevice`/`VacuumDevice`/`MowerDevice` structurally satisfies it. NOTE it
+ * exposes NO action/command method — the dumper literally cannot execute one.
+ */
+interface DumperDevice {
+    readonly model: string;
+    readonly deviceId: string;
+    readonly capabilities: {
+        list(): readonly string[];
+        has(t: string): boolean;
+        model: string;
+    };
+    on(event: 'propertyChanged', cb: (e: PropertyChangedEvent) => void): this;
+    on(event: 'event', cb: (e: DeviceEvent) => void): this;
+    off(event: 'propertyChanged', cb: (e: PropertyChangedEvent) => void): this;
+    off(event: 'event', cb: (e: DeviceEvent) => void): this;
+    /** Cloud-shadow read; absent on a bare BaseDevice. Feature-detected. */
+    refreshFromCache?(): Promise<void>;
+}
+/**
+ * A passive, READ-ONLY observer that records what a Dreame device exposes while
+ * it operates. {@link start} hooks the device's `propertyChanged`/`event` stream,
+ * does an initial + periodic cloud-shadow {@link DumperDevice.refreshFromCache}
+ * read (feature-detected), and snapshots the static catalog at construction.
+ * {@link stop} detaches every listener + clears the timer (idempotent, no leaks).
+ * {@link export} assembles the ANONYMIZED, zod-valid {@link DeviceDump}. The
+ * dumper NEVER executes a device command/action.
+ */
+declare class Dumper {
+    #private;
+    constructor(device: DumperDevice, catalog: DeviceDump['catalog'], type: string, decoders: Record<string, KeyDecoder>, options?: DumperOptions);
+    /** Attach to the live stream + arm the periodic shadow refresh. Idempotent. */
+    start(): Promise<void>;
+    /** Detach every listener + clear the timer. Idempotent. */
+    stop(): Promise<void>;
+    /** Build the anonymized, schema-valid dump. Works live or after {@link stop}. */
+    export(): DeviceDump;
+    /** Deterministic pretty JSON of {@link export}. */
+    exportJson(): string;
+}
+/**
+ * Create a read-only {@link Dumper} for one device. The family-correct decoder
+ * table + catalog + `device.type` are chosen via cast-free `instanceof` checks;
+ * an unknown family records values with no enum/unmapped detection.
+ */
+declare function createDumper(target: DumperDevice, options?: DumperOptions): Dumper;
+/**
+ * Fan-out: one {@link Dumper} per discovered device on a {@link Nodreame} client
+ * (read-only). Each `BaseDevice` structurally satisfies {@link DumperDevice}.
+ */
+declare function createClientDumper(client: Nodreame, options?: DumperOptions): Dumper[];
+
+export { BaseDevice, type BaseDeviceEvents, type BatchDeviceDataFetcher, type CapabilityResolver, ChargingStatus, type CleanOpts, CleaningMode, type CreateDeviceArgs, DefaultCapabilityResolver, type DeviceCapabilities, type DeviceDump, type DeviceEvent, DreameApiError, DreameAuthError, type DreameCloudState, type DreameDevice, DreameDeviceOfflineError, DreameError, type DreameRegion, type DreameSession, DreameTransportError, type DumperOptions, LIBRARY_NAME, MODEL_CAPABILITIES as MOWER_MODEL_CAPABILITIES, type MapBoundingBox, type MapCleanedAreaOverlay, 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 MowerAvailableMap, type MowerCapabilities, MowerCapabilityResolver, MowerChargingStatus, type MowerContour, MowerControlAction, type MowerControlState, MowerDevice, type MowerDeviceInput, MowerFault, type MowerMap, type MowerMapBoundary, type MowerMowPath, type MowerPathEntry, type MowerPoint, type MowerSpotArea, MowerStatus, type MowerTaskDescriptor, MowerTaskStatus, type MowerZone, Nodreame, type NodreameDeps, type NodreameEvents, type NodreameOptions, type OssFetchInput, type OssFetcherLike, type PropertyChangedEvent, type PropertyResult, type PropertyState, type PropertyWrite, type RenderMowerSvgOptions, type RenderVacuumPngOptions, type StateChangedEvent, SuctionLevel, TaskStatus, MODEL_CAPABILITIES$1 as VACUUM_MODEL_CAPABILITIES, type VacuumCapabilities, VacuumCapabilityResolver, VacuumDevice, type VacuumGetMapInput, type VacuumMap, WaterVolume, createClientDumper, createDumper, getMowerCapabilities, getVacuumCapabilities, renderMowerSvg, renderVacuumPng, resolveCapabilities };