matterbridge-dyson-robot 0.1.0

package/dist/dyson-mqtt-filter.js

@@ -0,0 +1,25 @@
+// Matterbridge plugin for Dyson robot vacuum and air treatment devices
+// Copyright © 2025 Alexander Thoukydides
+import { isDeepStrictEqual } from 'node:util';
+// Filter received Dyson MQTT messages for reordering and duplication
+export class DysonMQTTFilter {
+    log;
+    // The most recent message of each type (indexed by msg)
+    lastMsg = new Map;
+    // Create a new message filter
+    constructor(log) {
+        this.log = log;
+    }
+    // Filter a received message
+    filter(msg) {
+        const lastMsg = this.lastMsg.get(msg.msg);
+        if (lastMsg) {
+            if (msg.time < lastMsg.time)
+                return 'reordered';
+            if (isDeepStrictEqual(msg, lastMsg))
+                return 'duplicate';
+        }
+        this.lastMsg.set(msg.msg, structuredClone(msg));
+    }
+}
+//# sourceMappingURL=dyson-mqtt-filter.js.map

package/dist/dyson-mqtt-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dyson-mqtt-filter.js","sourceRoot":"","sources":["../src/dyson-mqtt-filter.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,yCAAyC;AAEzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAO9C,qEAAqE;AACrE,MAAM,OAAO,eAAe;IAMH;IAJrB,wDAAwD;IAC/C,OAAO,GAAG,IAAI,GAAqB,CAAC;IAE7C,8BAA8B;IAC9B,YAAqB,GAAe;QAAf,QAAG,GAAH,GAAG,CAAY;IAAG,CAAC;IAExC,4BAA4B;IAC5B,MAAM,CAAC,GAAa;QAChB,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,OAAO,EAAE,CAAC;YACV,IAAI,GAAG,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI;gBAAa,OAAO,WAAW,CAAC;YAC3D,IAAI,iBAAiB,CAAC,GAAG,EAAE,OAAO,CAAC;gBAAK,OAAO,WAAW,CAAC;QAC/D,CAAC;QACD,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,CAAC;CACJ"}

package/dist/dyson-mqtt-parse.d.ts

@@ -0,0 +1,16 @@
+import { AnsiLogger } from 'matterbridge/logger';
+import { CheckerT } from 'ts-interface-checker';
+import { DysonMsg } from './dyson-types.js';
+export type DysonMsgAny<T> = {
+    [K in keyof T]: T[K] extends DysonMsg ? T[K] : never;
+}[keyof T];
+export type DysonMsgTypeName<T> = Extract<keyof T, string>;
+export type DysonMsgCheckers<T> = {
+    [K in DysonMsgTypeName<T>]: CheckerT<T[K]>;
+};
+export interface DysonMqttParserConfig<T> {
+    prefix: string;
+    checkers: DysonMsgCheckers<T>;
+}
+export declare function dysonMqttParse<T>(log: AnsiLogger, config: DysonMqttParserConfig<T>, topic: string, normalise: boolean, payload: Buffer): DysonMsgAny<T>;
+//# sourceMappingURL=dyson-mqtt-parse.d.ts.map

package/dist/dyson-mqtt-parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dyson-mqtt-parse.d.ts","sourceRoot":"","sources":["../src/dyson-mqtt-parse.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAY,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAE,QAAQ,EAAgB,MAAM,sBAAsB,CAAC;AAE9D,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAK5C,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KACxB,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK;CACvD,CAAC,MAAM,CAAC,CAAC,CAAC;AACX,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;AAC3D,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,gBAAgB,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAAC;AAGjF,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACpC,MAAM,EAAM,MAAM,CAAC;IACnB,QAAQ,EAAI,gBAAgB,CAAC,CAAC,CAAC,CAAC;CACnC;AAGD,wBAAgB,cAAc,CAAC,CAAC,EAC5B,GAAG,EAAS,UAAU,EACtB,MAAM,EAAM,qBAAqB,CAAC,CAAC,CAAC,EACpC,KAAK,EAAO,MAAM,EAClB,SAAS,EAAG,OAAO,EACnB,OAAO,EAAK,MAAM,GACnB,WAAW,CAAC,CAAC,CAAC,CA8EhB"}

package/dist/dyson-mqtt-parse.js

@@ -0,0 +1,100 @@
+// Matterbridge plugin for Dyson robot vacuum and air treatment devices
+// Copyright © 2025 Alexander Thoukydides
+import { assertIsDefined, getValidationTree } from './utils.js';
+import { checkers as dysonMsgCheckers } from './ti/dyson-types.js';
+import { INSPECT_VERBOSE } from './logger-options.js';
+import { inspect } from 'util';
+// Parse and check a received MQTT message
+export function dysonMqttParse(log, config, topic, normalise, payload) {
+    // Parse a raw message buffer as JSON and normalise property names
+    const parseAndNormalise = (text) => {
+        try {
+            const parsed = JSON.parse(text);
+            return normalise ? normaliseKeys(parsed) : parsed;
+        }
+        catch (err) {
+            logCheckerValidation("error" /* LogLevel.ERROR */, text);
+            const message = err instanceof Error ? err.message : String(err);
+            throw new Error(`Failed to parse Dyson MQTT message as JSON: ${message}`);
+        }
+    };
+    // Check that a received message is known and matches the expected type
+    const assertIsDysonMsg = (payload) => {
+        // Check that the message is of the general form expected
+        const baseChecker = dysonMsgCheckers.DysonMsg;
+        if (!baseChecker.test(payload)) {
+            baseChecker.setReportedPath('DysonMsg');
+            const validation = baseChecker.validate(payload);
+            assertIsDefined(validation);
+            logCheckerValidation("error" /* LogLevel.ERROR */, payload, validation);
+            throw new Error('Unexpected structure of Dyson MQTT message');
+        }
+        // Check whether the message type is known
+        const checker = getCheckerForMsg(payload);
+        // Check that the message is of the form expected for this type
+        const validation = checker.validate(payload);
+        if (validation) {
+            logCheckerValidation("error" /* LogLevel.ERROR */, payload, validation);
+            throw new Error('Unexpected structure of Dyson MQTT message');
+        }
+        const strictValidation = checker.strictValidate(payload);
+        if (strictValidation) {
+            logCheckerValidation("warn" /* LogLevel.WARN */, payload, strictValidation);
+            // (Continue processing messages that include unexpected properties)
+        }
+    };
+    // Map a message name to the corresponding type checker
+    const getCheckerForMsg = (payload) => {
+        const { prefix, checkers } = config;
+        // Construct the type name for this message
+        const msgPascalCase = kebabToPascalCase(payload.msg);
+        const typeName = `${prefix}${msgPascalCase}`;
+        const assertIsTypeName = (name) => {
+            if (name in config.checkers)
+                return;
+            logCheckerValidation("error" /* LogLevel.ERROR */, payload);
+            throw new Error(`Unrecognised Dyson MQTT message type: ${name}`);
+        };
+        assertIsTypeName(typeName);
+        // Return the type checker
+        const checker = checkers[typeName];
+        checker.setReportedPath(String(typeName));
+        return checker;
+    };
+    // Log checker validation errors
+    const logCheckerValidation = (level, payload, errors) => {
+        // Log the formatted message
+        log.log(level, `MQTT topic '${topic}':`);
+        if (errors) {
+            const validationLines = getValidationTree(errors);
+            validationLines.forEach(line => { log.log(level, line); });
+        }
+        const payloadLines = inspect(payload, INSPECT_VERBOSE).split('\n');
+        payloadLines.forEach(line => { log.info(`    ${line}`); });
+    };
+    // Parse and check the message
+    const msg = parseAndNormalise(payload.toString());
+    assertIsDysonMsg(msg);
+    return msg;
+}
+// Convert a string from kebab-case (or FLAMING-KEBAB-CASE) to PascalCase
+function kebabToPascalCase(str) {
+    return str.toLowerCase().split('-')
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+        .join('');
+}
+// Convert a string from kebab-case or 'space case' to camelCase
+function kebabToCamelCase(str) {
+    return str.replace(/[-\s]([a-z])/g, (_, letter) => letter.toUpperCase());
+}
+// Recursively convert property names from snake-case to camelCase
+function normaliseKeys(obj) {
+    if (Array.isArray(obj)) {
+        return obj.map(item => normaliseKeys(item));
+    }
+    if (obj !== null && typeof obj === 'object') {
+        return Object.fromEntries(Object.entries(obj).map(([key, value]) => [kebabToCamelCase(key), normaliseKeys(value)]));
+    }
+    return obj;
+}
+//# sourceMappingURL=dyson-mqtt-parse.js.map

package/dist/dyson-mqtt-parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dyson-mqtt-parse.js","sourceRoot":"","sources":["../src/dyson-mqtt-parse.ts"],"names":[],"mappings":"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"}

package/dist/dyson-mqtt-subscribe.d.ts

@@ -0,0 +1,28 @@
+import EventEmitter from 'events';
+import { AnsiLogger } from 'matterbridge/logger';
+import { MqttClient } from 'mqtt';
+import { Config } from './config-types.js';
+export interface DysonMqttSubscribeConfig {
+    command: string;
+    subscribe: string[];
+    other?: string[];
+}
+export interface DysonMqttSubscribeEventMap {
+    error: [unknown];
+    subscribed: [];
+}
+export type DysonMqttTopic = 'subscribed' | 'command' | 'expected' | 'unexpected';
+export declare class DysonMqttSubscribe extends EventEmitter<DysonMqttSubscribeEventMap> {
+    readonly log: AnsiLogger;
+    readonly mqtt: MqttClient;
+    readonly config: Config;
+    readonly topics: DysonMqttSubscribeConfig;
+    readonly root_topic: string;
+    readonly username: string;
+    constructor(log: AnsiLogger, mqtt: MqttClient, config: Config, topics: DysonMqttSubscribeConfig, root_topic: string, username: string);
+    subscribe(): Promise<void>;
+    checkTopic(topic: string): DysonMqttTopic;
+    get commandTopic(): string;
+    replaceTopicPlaceholders(topic: string): string;
+}
+//# sourceMappingURL=dyson-mqtt-subscribe.d.ts.map

package/dist/dyson-mqtt-subscribe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dyson-mqtt-subscribe.d.ts","sourceRoot":"","sources":["../src/dyson-mqtt-subscribe.ts"],"names":[],"mappings":"AAGA,OAAO,YAAY,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,MAAM,MAAM,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAI3C,MAAM,WAAW,wBAAwB;IACrC,OAAO,EAAK,MAAM,CAAC;IACnB,SAAS,EAAG,MAAM,EAAE,CAAC;IACrB,KAAK,CAAC,EAAM,MAAM,EAAE,CAAC;CACxB;AAGD,MAAM,WAAW,0BAA0B;IACvC,KAAK,EAAO,CAAC,OAAO,CAAC,CAAC;IACtB,UAAU,EAAE,EAAE,CAAC;CAClB;AAGD,MAAM,MAAM,cAAc,GAAI,YAAY,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,CAAC;AAGnF,qBAAa,kBAAmB,SAAQ,YAAY,CAAC,0BAA0B,CAAC;IAIxE,QAAQ,CAAC,GAAG,EAAY,UAAU;IAClC,QAAQ,CAAC,IAAI,EAAW,UAAU;IAClC,QAAQ,CAAC,MAAM,EAAS,MAAM;IAC9B,QAAQ,CAAC,MAAM,EAAS,wBAAwB;IAChD,QAAQ,CAAC,UAAU,EAAK,MAAM;IAC9B,QAAQ,CAAC,QAAQ,EAAO,MAAM;gBALrB,GAAG,EAAY,UAAU,EACzB,IAAI,EAAW,UAAU,EACzB,MAAM,EAAS,MAAM,EACrB,MAAM,EAAS,wBAAwB,EACvC,UAAU,EAAK,MAAM,EACrB,QAAQ,EAAO,MAAM;IAY5B,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAsBhC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc;IAqBzC,IAAI,YAAY,IAAI,MAAM,CAEzB;IAGD,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAKlD"}

package/dist/dyson-mqtt-subscribe.js

@@ -0,0 +1,85 @@
+// Matterbridge plugin for Dyson robot vacuum and air treatment devices
+// Copyright © 2025 Alexander Thoukydides
+import EventEmitter from 'events';
+import { plural, tryListener } from './utils.js';
+// Manage Dyson MQTT topic subscriptions
+export class DysonMqttSubscribe extends EventEmitter {
+    log;
+    mqtt;
+    config;
+    topics;
+    root_topic;
+    username;
+    // Construct a new subscription manager
+    constructor(log, mqtt, config, topics, root_topic, username) {
+        super({ captureRejections: true });
+        this.log = log;
+        this.mqtt = mqtt;
+        this.config = config;
+        this.topics = topics;
+        this.root_topic = root_topic;
+        this.username = username;
+        // (Re)subscribe to topics when the MQTT (re)connects
+        mqtt.on('connect', tryListener(this, async (_connack) => {
+            await this.subscribe();
+            this.emit('subscribed');
+        }));
+    }
+    // Subscribe to topics when the client (re)connects
+    async subscribe() {
+        // Select the required subscription topics
+        const topics = this.topics.subscribe.map(t => this.replaceTopicPlaceholders(t));
+        if (this.config.wildcardTopic)
+            topics.push('#');
+        // Attempt the subscription
+        const grant = await this.mqtt.subscribeAsync(topics, { qos: 1 });
+        // Check whether
+        const failures = topics.filter(topic => !grant.some(g => g.topic === topic));
+        if (!grant.length) {
+            throw new Error(`MQTT subscribe unsuccessful: all ${plural(topics.length, 'topic')} rejected`);
+        }
+        else if (failures.length) {
+            this.log.warn('MQTT subscribe partially successful: '
+                + `${failures.length} of ${plural(topics.length, 'topic')} rejected`);
+            failures.forEach(topic => { this.log.warn(`    '${topic}'`); });
+        }
+        else {
+            this.log.info(`MQTT subscribe successful: all ${plural(grant.length, 'topic')} granted`);
+        }
+    }
+    // Warn if a received message's topic is unexpected
+    checkTopic(topic) {
+        // Check whether the topic is expected
+        const isTopics = (topics) => topics.some(t => this.replaceTopicPlaceholders(t) === topic);
+        if (isTopics([this.topics.command]))
+            return 'command';
+        if (isTopics(this.topics.subscribe))
+            return 'subscribed';
+        if (isTopics(this.topics.other ?? []))
+            return 'expected';
+        // Attempt to diagnose common problems
+        const [root_topic, username] = topic.split('/', 2);
+        if (root_topic !== this.root_topic) {
+            this.log.warn('MQTT topic root (product type) mismatch:'
+                + ` expected '${this.root_topic}', received '${root_topic}'`);
+        }
+        else if (username !== this.username) {
+            this.log.warn('MQTT topic username (product serial number) mismatch:'
+                + ` expected '${this.username}', received '${username}'`);
+        }
+        else {
+            this.log.warn(`Unexpected MQTT topic received: ${topic}`);
+        }
+        return 'unexpected';
+    }
+    get commandTopic() {
+        return this.replaceTopicPlaceholders(this.topics.command);
+    }
+    // Replace any placeholders in a topic
+    replaceTopicPlaceholders(topic) {
+        return topic
+            .replace('@', this.root_topic)
+            .replace('@', this.username);
+    }
+}
+//# sourceMappingURL=dyson-mqtt-subscribe.js.map

package/dist/dyson-mqtt-subscribe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dyson-mqtt-subscribe.js","sourceRoot":"","sources":["../src/dyson-mqtt-subscribe.ts"],"names":[],"mappings":"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"}

package/dist/dyson-mqtt.d.ts

@@ -0,0 +1,51 @@
+import { AnsiLogger } from 'matterbridge/logger';
+import { Config, DeviceConfig } from './config-types.js';
+import EventEmitter from 'events';
+import { DysonMsg } from './dyson-types.js';
+import { DysonMqttParserConfig, DysonMsgAny } from './dyson-mqtt-parse.js';
+import { DysonMqttSubscribeConfig } from './dyson-mqtt-subscribe.js';
+import { DysonMqttFiltered } from './dyson-mqtt-filter.js';
+import { AsyncEventEmitter } from './async-eventemitter.js';
+export interface DysonMqttConfig<T> {
+    topics: DysonMqttSubscribeConfig;
+    messages: DysonMqttParserConfig<T>;
+}
+export interface DysonMqttStatusBase {
+    reachable: boolean;
+    initialised: boolean;
+}
+export type DysonMqttStatus<T> = T & DysonMqttStatusBase;
+export interface DysonMqttEventMapBase {
+    error: [unknown];
+    subscribed: [];
+    status: [];
+}
+export interface DysonMqttEventMap<T> extends DysonMqttEventMapBase {
+    message: [DysonMsgAny<T>];
+}
+export type PublishArgs<T, O extends string> = {
+    [K in keyof T]: T[K] extends DysonMsg ? (Omit<T[K], O | 'msg'> extends Record<string, never> ? [T[K]['msg']] : [T[K]['msg'], Omit<T[K], O | 'msg'>]) : never;
+}[keyof T];
+export interface DysonMqttLike extends EventEmitter {
+    waitUntilInitialised(): Promise<void>;
+    stop(): Promise<void>;
+}
+export declare abstract class DysonMqtt<T, S> extends AsyncEventEmitter<DysonMqttEventMap<T>> implements DysonMqttLike {
+    readonly log: AnsiLogger;
+    readonly config: Config;
+    readonly deviceConfig: DeviceConfig;
+    readonly mqttConfig: DysonMqttConfig<T>;
+    private mqtt;
+    private mqttConnection;
+    private mqttSubscribe;
+    private mqttFilter;
+    readonly status: DysonMqttStatus<S>;
+    constructor(log: AnsiLogger, config: Config, deviceConfig: DeviceConfig, mqttConfig: DysonMqttConfig<T>);
+    downTimerHandle?: NodeJS.Timeout;
+    updateReachable(reachable: boolean): void;
+    waitUntilInitialised(): Promise<void>;
+    stop(): Promise<void>;
+    publish(...[msg, params]: PublishArgs<T, 'time'>): Promise<void>;
+    logPayload(direction: 'publish' | 'receive', topic: string, payload: DysonMsg, filter?: DysonMqttFiltered): void;
+}
+//# sourceMappingURL=dyson-mqtt.d.ts.map

package/dist/dyson-mqtt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dyson-mqtt.d.ts","sourceRoot":"","sources":["../src/dyson-mqtt.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,YAAY,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EACH,qBAAqB,EACrB,WAAW,EAEd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEH,wBAAwB,EAC3B,MAAM,2BAA2B,CAAC;AAOnC,OAAO,EAAmB,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAG5D,MAAM,WAAW,eAAe,CAAC,CAAC;IAC9B,MAAM,EAAM,wBAAwB,CAAC;IACrC,QAAQ,EAAI,qBAAqB,CAAC,CAAC,CAAC,CAAC;CACxC;AAGD,MAAM,WAAW,mBAAmB;IAChC,SAAS,EAAO,OAAO,CAAC;IACxB,WAAW,EAAK,OAAO,CAAC;CAC3B;AACD,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC;AAGzD,MAAM,WAAW,qBAAqB;IAClC,KAAK,EAAW,CAAC,OAAO,CAAC,CAAC;IAC1B,UAAU,EAAM,EAAE,CAAC;IACnB,MAAM,EAAU,EAAE,CAAC;CACtB;AACD,MAAM,WAAW,iBAAiB,CAAC,CAAC,CAAE,SAAQ,qBAAqB;IAC/D,OAAO,EAAS,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;CACpC;AAGD,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI;KAC1C,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,QAAQ,GAC/B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GACjD,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GACb,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,GACxC,KAAK;CACd,CAAC,MAAM,CAAC,CAAC,CAAC;AAMX,MAAM,WAAW,aAAc,SAAQ,YAAY;IAC/C,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAGD,8BAAsB,SAAS,CAAC,CAAC,EAAE,CAAC,CAChC,SAAQ,iBAAiB,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAE,YAAW,aAAa;IAgBpE,QAAQ,CAAC,GAAG,EAAY,UAAU;IAClC,QAAQ,CAAC,MAAM,EAAS,MAAM;IAC9B,QAAQ,CAAC,YAAY,EAAG,YAAY;IACpC,QAAQ,CAAC,UAAU,EAAK,eAAe,CAAC,CAAC,CAAC;IAhB9C,OAAO,CAAC,IAAI,CAAuB;IACnC,OAAO,CAAC,cAAc,CAAsB;IAC5C,OAAO,CAAC,aAAa,CAAsB;IAC3C,OAAO,CAAC,UAAU,CAAsB;IAGxC,QAAQ,CAAC,MAAM,EAGV,eAAe,CAAC,CAAC,CAAC,CAAC;gBAIX,GAAG,EAAY,UAAU,EACzB,MAAM,EAAS,MAAM,EACrB,YAAY,EAAG,YAAY,EAC3B,UAAU,EAAK,eAAe,CAAC,CAAC,CAAC;IAwC9C,eAAe,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC;IACjC,eAAe,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI;IA0BnC,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAKrB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAatE,UAAU,CAAC,SAAS,EAAE,SAAS,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,iBAAiB,GAAG,IAAI;CAwBnH"}

package/dist/dyson-mqtt.js

@@ -0,0 +1,138 @@
+// Matterbridge plugin for Dyson robot vacuum and air treatment devices
+// Copyright © 2025 Alexander Thoukydides
+import { INSPECT_SINGLE_LINE, MM, MP, MR, RD, SR, ST } from './logger-options.js';
+import { MS, tryListener } from './utils.js';
+import { isConfigMqtt } from './dyson-mqtt-config.js';
+import { dysonMqttParse } from './dyson-mqtt-parse.js';
+import { DysonMqttSubscribe } from './dyson-mqtt-subscribe.js';
+import { DysonMqttConnectionIoT, DysonMqttConnectionLocal } from './dyson-mqtt-connect.js';
+import { inspect } from 'util';
+import { DysonMQTTFilter } from './dyson-mqtt-filter.js';
+import { AsyncEventEmitter } from './async-eventemitter.js';
+;
+// Minimum disconnection time before indicating device not reachable
+const MIN_DOWN_TIME = 5 * MS; // 5 seconds
+// Dyson MQTT client for all device types
+export class DysonMqtt extends AsyncEventEmitter {
+    log;
+    config;
+    deviceConfig;
+    mqttConfig;
+    // The MQTT client
+    mqtt;
+    mqttConnection;
+    mqttSubscribe;
+    mqttFilter;
+    // The current status
+    status = {
+        reachable: false,
+        initialised: false
+    };
+    // Construct a new MQTT client
+    constructor(log, config, deviceConfig, mqttConfig) {
+        super({ captureRejections: true });
+        this.log = log;
+        this.config = config;
+        this.deviceConfig = deviceConfig;
+        this.mqttConfig = mqttConfig;
+        // Configure the MQTT client
+        this.mqttConnection = isConfigMqtt(deviceConfig)
+            ? new DysonMqttConnectionLocal(log, config, deviceConfig)
+            : new DysonMqttConnectionIoT(log, config, deviceConfig);
+        this.mqtt = this.mqttConnection.mqtt;
+        this.mqtt.on('close', tryListener(this, () => { this.updateReachable(false); }));
+        // Manage MQTT topic subscriptions
+        const { root_topic, username } = deviceConfig;
+        this.mqttSubscribe = new DysonMqttSubscribe(log, this.mqtt, config, mqttConfig.topics, root_topic, username);
+        this.mqttSubscribe.on('error', err => this.emit('error', err));
+        this.mqttSubscribe.on('subscribed', () => {
+            this.emit('subscribed');
+            this.updateReachable(true);
+        });
+        // Handle received MQTT messages
+        this.mqttFilter = new DysonMQTTFilter(log);
+        this.mqtt.on('message', tryListener(this, (topic, payload) => {
+            // Check the received topic and message
+            const topicStatus = this.mqttSubscribe.checkTopic(topic);
+            const normalise = topicStatus !== 'command';
+            const msg = dysonMqttParse(log, mqttConfig.messages, topic, normalise, payload);
+            const filter = this.mqttFilter.filter(msg);
+            // Dispatch the validated message and indicate a status update
+            this.logPayload('receive', topic, msg, filter);
+            if (!filter && topicStatus === 'subscribed') {
+                this.emit('message', msg);
+                this.emit('status');
+            }
+        }));
+    }
+    // Update the device reachability, with hysteresis on unreachable indications
+    downTimerHandle;
+    updateReachable(reachable) {
+        if (reachable) {
+            // Cancel any pending down timer
+            clearTimeout(this.downTimerHandle);
+            this.downTimerHandle = undefined;
+            // Mark the device as reachable
+            if (!this.status.reachable) {
+                this.status.reachable = true;
+                this.emit('status');
+            }
+        }
+        else {
+            // Only start down timer if not already running
+            if (!this.downTimerHandle && this.status.reachable) {
+                this.downTimerHandle = setTimeout(() => {
+                    // Mark the device as not reachable after a delay
+                    this.log.error('MQTT client is down');
+                    this.downTimerHandle = undefined;
+                    this.status.reachable = false;
+                    this.emit('status');
+                }, MIN_DOWN_TIME);
+            }
+        }
+    }
+    // Wait until the device is reachable and all initial state has been received
+    async waitUntilInitialised() {
+        while (!this.status.reachable || !this.status.initialised) {
+            await this.onceAsync('status');
+        }
+    }
+    // Stop the MQTT client
+    async stop() {
+        await this.mqttConnection.stop();
+    }
+    // Publish a command
+    async publish(...[msg, params]) {
+        // Construct the full message
+        const time = new Date().toISOString();
+        const fullMsg = { msg, ...params, time };
+        const payload = JSON.stringify(fullMsg);
+        // Publish to the command topic
+        const topic = this.mqttSubscribe.commandTopic;
+        this.logPayload('publish', topic, fullMsg);
+        await this.mqtt.publishAsync(topic, payload, { qos: 1, retain: false });
+    }
+    // Log received or transmitted message payloads
+    logPayload(direction, topic, payload, filter) {
+        if (!this.config.debugFeatures.includes('Log MQTT Payloads'))
+            return;
+        // List the fixed fields first
+        const { msg, time, ...other } = payload;
+        const properties = [
+            `msg: ${direction === 'publish' ? MP : MR}'${msg}'${MM}`,
+            `time: ${RD}'${time}'${MM}`
+        ];
+        // Include the other fields from the message, unless it is a duplicate
+        if (filter === 'duplicate') {
+            properties.push('...');
+        }
+        else {
+            properties.push(...Object.entries(other).sort().map(([key, value]) => `${key}: ${inspect(value, INSPECT_SINGLE_LINE)}`));
+        }
+        // Log the message (formatting with strikethrough if dropped by filter)
+        const object = `${MM}{ ${properties.join(', ')} }${RD}`;
+        this.log.debug(filter ? `MQTT ${direction}: ${ST}${object}${SR} (${filter})`
+            : `MQTT ${direction}: ${object} topic '${topic}'`);
+    }
+}
+//# sourceMappingURL=dyson-mqtt.js.map

package/dist/dyson-mqtt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dyson-mqtt.js","sourceRoot":"","sources":["../src/dyson-mqtt.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,yCAAyC;AAGzC,OAAO,EAAE,mBAAmB,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAC;AAGlF,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG7C,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAGH,cAAc,EACjB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACH,kBAAkB,EAErB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAEH,sBAAsB,EACtB,wBAAwB,EAC3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,eAAe,EAAqB,MAAM,wBAAwB,CAAC;AAC5E,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAY3D,CAAC;AAsBF,oEAAoE;AACpE,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,YAAY;AAQ1C,yCAAyC;AACzC,MAAM,OAAgB,SAClB,SAAQ,iBAAuC;IAgBlC;IACA;IACA;IACA;IAjBb,kBAAkB;IACV,IAAI,CAAuB;IAC3B,cAAc,CAAsB;IACpC,aAAa,CAAsB;IACnC,UAAU,CAAsB;IAExC,qBAAqB;IACZ,MAAM,GAAG;QACd,SAAS,EAAO,KAAK;QACrB,WAAW,EAAK,KAAK;KACF,CAAC;IAExB,8BAA8B;IAC9B,YACa,GAAyB,EACzB,MAAqB,EACrB,YAA2B,EAC3B,UAAiC;QAE1C,KAAK,CAAC,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;QAL1B,QAAG,GAAH,GAAG,CAAsB;QACzB,WAAM,GAAN,MAAM,CAAe;QACrB,iBAAY,GAAZ,YAAY,CAAe;QAC3B,eAAU,GAAV,UAAU,CAAuB;QAI1C,4BAA4B;QAC5B,IAAI,CAAC,cAAc,GAAG,YAAY,CAAC,YAAY,CAAC;YAC5C,CAAC,CAAC,IAAI,wBAAwB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC;YACzD,CAAC,CAAC,IAAI,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC;QAC5D,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC;QACrC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAEjF,kCAAkC;QAClC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,GAAG,YAAY,CAAC;QAC9C,IAAI,CAAC,aAAa,GAAG,IAAI,kBAAkB,CACvC,GAAG,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;QACrE,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC;QAC/D,IAAI,CAAC,aAAa,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,EAAE;YACrC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACxB,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC,CAAC,CAAC;QAEH,gCAAgC;QAChC,IAAI,CAAC,UAAU,GAAG,IAAI,eAAe,CAAC,GAAG,CAAC,CAAC;QAC3C,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YACzD,uCAAuC;YACvC,MAAM,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YACzD,MAAM,SAAS,GAAG,WAAW,KAAK,SAAS,CAAC;YAC5C,MAAM,GAAG,GAAG,cAAc,CAAI,GAAG,EAAE,UAAU,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;YACnF,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAE3C,8DAA8D;YAC9D,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;YAC/C,IAAI,CAAC,MAAM,IAAI,WAAW,KAAK,YAAY,EAAE,CAAC;gBAC1C,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;gBAC1B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxB,CAAC;QACL,CAAC,CAAC,CAAC,CAAC;IACR,CAAC;IAED,6EAA6E;IAC7E,eAAe,CAAkB;IACjC,eAAe,CAAC,SAAkB;QAC9B,IAAI,SAAS,EAAE,CAAC;YACZ,gCAAgC;YAChC,YAAY,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;YACnC,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;YAEjC,+BAA+B;YAC/B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBACzB,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;gBAC7B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACxB,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,+CAA+C;YAC/C,IAAI,CAAC,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;gBACjD,IAAI,CAAC,eAAe,GAAG,UAAU,CAAC,GAAG,EAAE;oBACnC,iDAAiD;oBACjD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;oBACtC,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;oBACjC,IAAI,CAAC,MAAM,CAAC,SAAS,GAAG,KAAK,CAAC;oBAC9B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACxB,CAAC,EAAE,aAAa,CAAC,CAAC;YACtB,CAAC;QACL,CAAC;IACL,CAAC;IAED,6EAA6E;IAC7E,KAAK,CAAC,oBAAoB;QACtB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YACxD,MAAM,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACnC,CAAC;IACL,CAAC;IAED,uBAAuB;IACvB,KAAK,CAAC,IAAI;QACN,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;IACrC,CAAC;IAED,oBAAoB;IACpB,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAyB;QAClD,6BAA6B;QAC7B,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QACtC,MAAM,OAAO,GAAG,EAAE,GAAG,EAAE,GAAG,MAAM,EAAE,IAAI,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;QAExC,+BAA+B;QAC/B,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,YAAY,CAAC;QAC9C,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;QAC3C,MAAM,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,+CAA+C;IAC/C,UAAU,CAAC,SAAgC,EAAE,KAAa,EAAE,OAAiB,EAAE,MAA0B;QACrG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,mBAAmB,CAAC;YAAE,OAAO;QAErE,8BAA8B;QAC9B,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;QACxC,MAAM,UAAU,GAAG;YACf,QAAQ,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG,IAAI,EAAE,EAAE;YACxD,SAAS,EAAE,IAAI,IAAI,IAAI,EAAE,EAAE;SAC9B,CAAC;QAEF,sEAAsE;QACtE,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;YACzB,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC;aAAM,CAAC;YACJ,UAAU,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAC/C,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,KAAK,OAAO,CAAC,KAAK,EAAE,mBAAmB,CAAC,EAAE,CACrE,CAAC,CAAC;QACP,CAAC;QAED,uEAAuE;QACvE,MAAM,MAAM,GAAG,GAAG,EAAE,KAAK,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;QACxD,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,SAAS,KAAK,EAAE,GAAG,MAAM,GAAG,EAAE,KAAK,MAAM,GAAG;YACtD,CAAC,CAAC,QAAQ,SAAS,KAAK,MAAM,WAAW,KAAK,GAAG,CAAC,CAAC;IAC7E,CAAC;CACJ"}

package/dist/dyson-types.d.ts

@@ -0,0 +1,18 @@
+export interface DysonMsg {
+    msg: string;
+    time: string;
+}
+export declare enum DysonModeReason {
+    Unknown = "",
+    LocalApp = "LAPP",
+    LocalSchedule = "LSCH",
+    RemoteApp = "RAPP",
+    Preconditioning = "PRC",
+    PhysicalUserInteraction = "PUI"
+}
+export declare enum DysonStateReason {
+    Environment = "ENV",
+    FLT = "FLT",
+    Mode = "MODE"
+}
+//# sourceMappingURL=dyson-types.d.ts.map

package/dist/dyson-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dyson-types.d.ts","sourceRoot":"","sources":["../src/dyson-types.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,QAAQ;IACrB,GAAG,EAAqB,MAAM,CAAC;IAC/B,IAAI,EAAoB,MAAM,CAAC;CAClC;AAGD,oBAAY,eAAe;IACvB,OAAO,KAAqB;IAC5B,QAAQ,SAAwB;IAChC,aAAa,SAAmB;IAChC,SAAS,SAAuB;IAChC,eAAe,QAAgB;IAC/B,uBAAuB,QAAQ;CAClC;AAGD,oBAAY,gBAAgB;IACxB,WAAW,QAAoB;IAC/B,GAAG,QAA4B;IAC/B,IAAI,SAA4B;CACnC"}

package/dist/dyson-types.js

@@ -0,0 +1,20 @@
+// Matterbridge plugin for Dyson robot vacuum and air treatment devices
+// Copyright © 2025 Alexander Thoukydides
+// Dyson mode reason
+export var DysonModeReason;
+(function (DysonModeReason) {
+    DysonModeReason["Unknown"] = "";
+    DysonModeReason["LocalApp"] = "LAPP";
+    DysonModeReason["LocalSchedule"] = "LSCH";
+    DysonModeReason["RemoteApp"] = "RAPP";
+    DysonModeReason["Preconditioning"] = "PRC";
+    DysonModeReason["PhysicalUserInteraction"] = "PUI";
+})(DysonModeReason || (DysonModeReason = {}));
+// Dyson state reason
+export var DysonStateReason;
+(function (DysonStateReason) {
+    DysonStateReason["Environment"] = "ENV";
+    DysonStateReason["FLT"] = "FLT";
+    DysonStateReason["Mode"] = "MODE";
+})(DysonStateReason || (DysonStateReason = {}));
+//# sourceMappingURL=dyson-types.js.map

package/dist/dyson-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dyson-types.js","sourceRoot":"","sources":["../src/dyson-types.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,yCAAyC;AAQzC,oBAAoB;AACpB,MAAM,CAAN,IAAY,eAOX;AAPD,WAAY,eAAe;IACvB,+BAA4B,CAAA;IAC5B,oCAAgC,CAAA;IAChC,yCAAgC,CAAA;IAChC,qCAAgC,CAAA;IAChC,0CAA+B,CAAA;IAC/B,kDAA+B,CAAA;AACnC,CAAC,EAPW,eAAe,KAAf,eAAe,QAO1B;AAED,qBAAqB;AACrB,MAAM,CAAN,IAAY,gBAIX;AAJD,WAAY,gBAAgB;IACxB,uCAA+B,CAAA;IAC/B,+BAA+B,CAAA;IAC/B,iCAAgC,CAAA;AACpC,CAAC,EAJW,gBAAgB,KAAhB,gBAAgB,QAI3B"}

package/dist/endpoint-360-behavior.d.ts

@@ -0,0 +1,55 @@
+import { Behavior, MaybePromise } from 'matterbridge/matter';
+import { ModeBase, RvcOperationalState } from 'matterbridge/matter/clusters';
+import { RvcCleanModeBehavior, RvcOperationalStateBehavior, RvcRunModeBehavior } from 'matterbridge/matter/behaviors';
+import { AnsiLogger } from 'matterbridge/logger';
+export declare enum RvcRunMode360 {
+    Idle = 0,
+    Cleaning = 1,
+    Mapping = 2
+}
+export declare enum RvcCleanMode360 {
+    Quiet = 0,// Eye: Quiet  Heurist: Quiet  Vis Nav: Quiet
+    Quick = 1,//                             Vis Nav: Quick
+    High = 2,//             Heurist: High
+    MaxBoost = 3,// Eye: Max    Heurist: Max    Vis Nav: Boost
+    Auto = 4
+}
+export declare const VENDOR_ERROR_360 = 128;
+export interface EndpointCommands360 {
+    ChangeRunMode: (newMode: RvcRunMode360) => MaybePromise;
+    ChangeCleanMode: (newMode: RvcCleanMode360) => MaybePromise;
+    Pause: () => MaybePromise;
+    Resume: () => MaybePromise;
+    GoHome: () => MaybePromise;
+}
+type EndpointCommand360Args<T extends keyof EndpointCommands360> = Parameters<EndpointCommands360[T]>;
+export declare class BehaviorDevice360 {
+    readonly log: AnsiLogger;
+    readonly commands: Partial<EndpointCommands360>;
+    constructor(log: AnsiLogger);
+    setCommandHandler<Command extends keyof EndpointCommands360>(command: Command, handler: EndpointCommands360[Command]): void;
+    executeCommand<Command extends keyof EndpointCommands360>(command: Command, ...args: EndpointCommand360Args<Command>): Promise<void>;
+}
+export declare class Behavior360 extends Behavior {
+    static readonly id = "dyson-rvc";
+    state: Behavior360.State;
+}
+export declare namespace Behavior360 {
+    class State {
+        device: BehaviorDevice360;
+    }
+}
+export declare class RvcRunModeServer360 extends RvcRunModeBehavior {
+    changeToMode({ newMode }: ModeBase.ChangeToModeRequest): Promise<ModeBase.ChangeToModeResponse>;
+}
+export declare class RvcCleanModeServer360 extends RvcCleanModeBehavior {
+    changeToMode({ newMode }: ModeBase.ChangeToModeRequest): Promise<ModeBase.ChangeToModeResponse>;
+}
+export declare class RvcOperationalStateServer360 extends RvcOperationalStateBehavior {
+    command(command: 'Pause' | 'Resume' | 'GoHome', defaultErrorId: RvcOperationalState.ErrorState): Promise<RvcOperationalState.OperationalCommandResponse>;
+    pause(): Promise<RvcOperationalState.OperationalCommandResponse>;
+    resume(): Promise<RvcOperationalState.OperationalCommandResponse>;
+    goHome(): Promise<RvcOperationalState.OperationalCommandResponse>;
+}
+export {};
+//# sourceMappingURL=endpoint-360-behavior.d.ts.map

package/dist/endpoint-360-behavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpoint-360-behavior.d.ts","sourceRoot":"","sources":["../src/endpoint-360-behavior.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAE7D,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAC7E,OAAO,EACH,oBAAoB,EACpB,2BAA2B,EAC3B,kBAAkB,EACrB,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAKjD,oBAAY,aAAa;IACrB,IAAI,IAAA;IACJ,QAAQ,IAAA;IACR,OAAO,IAAA;CACV;AAGD,oBAAY,eAAe;IACvB,KAAK,IAAA,CAAO,6CAA6C;IACzD,KAAK,IAAA,CAAO,6CAA6C;IACzD,IAAI,IAAA,CAAQ,4BAA4B;IACxC,QAAQ,IAAA,CAAI,6CAA6C;IACzD,IAAI,IAAA;CACP;AAGD,eAAO,MAAM,gBAAgB,MAAO,CAAC;AAGrC,MAAM,WAAW,mBAAmB;IAChC,aAAa,EAAI,CAAC,OAAO,EAAE,aAAa,KAAO,YAAY,CAAC;IAC5D,eAAe,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,YAAY,CAAC;IAC5D,KAAK,EAAY,MAA8B,YAAY,CAAC;IAC5D,MAAM,EAAW,MAA8B,YAAY,CAAC;IAC5D,MAAM,EAAW,MAA8B,YAAY,CAAC;CAC/D;AACD,KAAK,sBAAsB,CAAC,CAAC,SAAS,MAAM,mBAAmB,IAAI,UAAU,CAAC,mBAAmB,CAAC,CAAC,CAAC,CAAC,CAAC;AAItG,qBAAa,iBAAiB;IAMd,QAAQ,CAAC,GAAG,EAAE,UAAU;IAHpC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,mBAAmB,CAAC,CAAM;gBAGhC,GAAG,EAAE,UAAU;IAGpC,iBAAiB,CAAC,OAAO,SAAS,MAAM,mBAAmB,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,mBAAmB,CAAC,OAAO,CAAC,GAAG,IAAI;IAMrH,cAAc,CAAC,OAAO,SAAS,MAAM,mBAAmB,EAC1D,OAAO,EAAK,OAAO,EACnB,GAAG,IAAI,EAAK,sBAAsB,CAAC,OAAO,CAAC,GAC5C,OAAO,CAAC,IAAI,CAAC;CAKnB;AACD,qBAAa,WAAY,SAAQ,QAAQ;IACrC,gBAAyB,EAAE,eAAe;IAClC,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC;CACpC;AAED,yBAAiB,WAAW,CAAC;IACzB,MAAa,KAAK;QACd,MAAM,EAAG,iBAAiB,CAAC;KAC9B;CACJ;AAGD,qBAAa,mBAAoB,SAAQ,kBAAkB;IAGjD,YAAY,CAAC,EAAE,OAAO,EAAE,EAAE,QAAQ,CAAC,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC;CAoBxG;AAGD,qBAAa,qBAAsB,SAAQ,oBAAoB;IAGrD,YAAY,CAAC,EAAE,OAAO,EAAE,EAAE,QAAQ,CAAC,mBAAmB,GAAG,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC;CAoBxG;AAGD,qBAAa,4BAA6B,SAAQ,2BAA2B;IAuBnE,OAAO,CACT,OAAO,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,EACtC,cAAc,EAAE,mBAAmB,CAAC,UAAU,GAC/C,OAAO,CAAC,mBAAmB,CAAC,0BAA0B,CAAC;IAejD,KAAK,IAAK,OAAO,CAAC,mBAAmB,CAAC,0BAA0B,CAAC;IAKjE,MAAM,IAAI,OAAO,CAAC,mBAAmB,CAAC,0BAA0B,CAAC;IAKjE,MAAM,IAAI,OAAO,CAAC,mBAAmB,CAAC,0BAA0B,CAAC;CAG7E"}