matterbridge-dyson-robot 0.1.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"dyson-types.d.ts","sourceRoot":"","sources":["../../src/ti/dyson-types.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAkB,aAAa,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAClG,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAKhF,MAAM,WAAW,OAAO;IACpB,QAAQ,EAAE,QAAQ,CAAC;IACnB,eAAe,EAAE,eAAe,CAAC;IACjC,gBAAgB,EAAE,gBAAgB,CAAC;CACtC;AAGD,eAAO,MAAM,SAAS,EAAwB,UAAU,GAAG;IACvD,QAAQ,EAAE,KAAK,CAAC;IAChB,eAAe,EAAE,KAAK,CAAC;IACvB,gBAAgB,EAAE,KAAK,CAAC;CAC3B,CAAC;AAGF,eAAO,MAAM,QAAQ,EAAgC,aAAa,GAAG;IACjE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC7B,eAAe,EAAE,QAAQ,CAAC,eAAe,CAAC,CAAC;IAC3C,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;CAChD,CAAC;AAGF,eAAe,QAAQ,CAAC"}

package/dist/ti/dyson-types.js

@@ -0,0 +1,11 @@
+// This module was automatically generated by node ts-interface-post.ts
+// 2025-05-16T17:16:14.902Z
+import { createCheckers } from 'ts-interface-checker';
+import exportedTypeSuite from './dyson-types-ti.js';
+// Type definitions
+export const typeSuite = exportedTypeSuite;
+// Checkers
+export const checkers = createCheckers(typeSuite);
+// Export the checkers by default
+export default checkers;
+//# sourceMappingURL=dyson-types.js.map

package/dist/ti/dyson-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dyson-types.js","sourceRoot":"","sources":["../../src/ti/dyson-types.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,2BAA2B;AAE3B,OAAO,EAAY,cAAc,EAAoC,MAAM,sBAAsB,CAAC;AAElG,OAAO,iBAAiB,MAAM,qBAAqB,CAAC;AAUpD,mBAAmB;AACnB,MAAM,CAAC,MAAM,SAAS,GAAG,iBAIxB,CAAC;AAEF,WAAW;AACX,MAAM,CAAC,MAAM,QAAQ,GAAG,cAAc,CAAC,SAAS,CAI/C,CAAC;AAEF,iCAAiC;AACjC,eAAe,QAAQ,CAAC"}

package/dist/utils.d.ts

@@ -0,0 +1,24 @@
+import EventEmitter from 'events';
+import { AnsiLogger } from 'matterbridge/logger';
+import { MaybePromise } from 'matterbridge/matter';
+import { IErrorDetail } from 'ts-interface-checker';
+export declare const MS = 1000;
+export type Constructor<T = object> = new (...args: any[]) => T;
+export type AbstractConstructor<T = object> = abstract new (...args: any[]) => T;
+export type UnionToIntersection<U> = (U extends unknown ? (x: U) => unknown : never) extends (x: infer I) => unknown ? I : never;
+export declare function assertIsDefined<Type>(value: Type): asserts value is NonNullable<Type>;
+export declare function assertIsNotUndefined<Type>(value: Type): asserts value is Exclude<Type, undefined>;
+export declare function assertIsBoolean(value: unknown): asserts value is boolean;
+export declare function assertIsNumber(value: unknown): asserts value is number;
+export declare function assertIsInstanceOf<Type extends object>(value: unknown, type: Constructor<Type>): asserts value is Type;
+export declare function logError(log: AnsiLogger, when: string, err: unknown): void;
+export declare function formatMilliseconds(ms: number, maxParts?: number): string;
+export declare function formatSeconds(seconds: number, maxParts?: number): string;
+export declare function formatDateISO8601(date: Date, separator: '' | '-'): string;
+export declare function formatList(items: string[]): string;
+export declare function plural(count: number, noun: string | [string, string], showCount?: boolean): string;
+export declare function columns(rows: string[][], separator?: string): string[];
+export declare function deepMerge(...objects: object[]): object;
+export declare function getValidationTree(errors: IErrorDetail[]): string[];
+export declare function tryListener<T extends unknown[]>(emitter: EventEmitter, op: (...args: T) => MaybePromise, errorHandler?: (err: unknown) => void): (...args: T) => void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAIA,OAAO,YAAY,MAAM,QAAQ,CAAC;AAClC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGpD,eAAO,MAAM,EAAE,OAAO,CAAC;AAGvB,MAAM,MAAM,WAAW,CAAS,CAAC,GAAG,MAAM,IAAa,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AACjF,MAAM,MAAM,mBAAmB,CAAC,CAAC,GAAG,MAAM,IAAI,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAGjF,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAC7B,CAAC,CAAC,SAAS,OAAO,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,OAAO,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,OAAO,GAAG,CAAC,GAAG,KAAK,CAAC;AAGhG,wBAAgB,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,KAAK,IAAI,WAAW,CAAC,IAAI,CAAC,CAGrF;AACD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAEjG;AACD,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAExE;AACD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,MAAM,CAEtE;AACD,wBAAgB,kBAAkB,CAAC,IAAI,SAAS,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,CAEtH;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAQ1E;AAGD,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAoBnE;AAGD,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,SAAI,GAAG,MAAM,CAEnE;AAGD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,GAAG,GAAG,GAAG,MAAM,CAKzE;AAGD,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAOlD;AAGD,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,SAAS,UAAO,GAAG,MAAM,CAkB/F;AAGD,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,SAAO,GAAG,MAAM,EAAE,CAYpE;AAGD,wBAAgB,SAAS,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,GAAG,MAAM,CAYtD;AAGD,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,EAAE,CAWlE;AAGD,wBAAgB,WAAW,CAAC,CAAC,SAAS,OAAO,EAAE,EAC3C,OAAO,EAAS,YAAY,EAC5B,EAAE,EAAc,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,YAAY,EAC5C,YAAY,GAAI,CAAC,GAAG,EAAE,OAAO,KAAK,IAA0C,GAC7E,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,IAAI,CAUtB"}

package/dist/utils.js

@@ -0,0 +1,150 @@
+// Matterbridge plugin for Dyson robot vacuum and air treatment devices
+// Copyright © 2025 Alexander Thoukydides
+import assert from 'assert';
+// Milliseconds in a second
+export const MS = 1000;
+// Type assertions
+export function assertIsDefined(value) {
+    assert.notStrictEqual(value, undefined);
+    assert.notStrictEqual(value, null);
+}
+export function assertIsNotUndefined(value) {
+    assert.notStrictEqual(value, undefined);
+}
+export function assertIsBoolean(value) {
+    assert.strictEqual(typeof value, 'boolean');
+}
+export function assertIsNumber(value) {
+    assert.strictEqual(typeof value, 'number');
+}
+export function assertIsInstanceOf(value, type) {
+    assert(value instanceof type, `Not an instance of ${type.name}`);
+}
+// Log an error
+export function logError(log, when, err) {
+    try {
+        // Log the error message itself
+        log.error(`[${when}] ${String(err)}`);
+        // Log any stack backtrace
+        if (err instanceof Error && err.stack)
+            log.debug(err.stack);
+    }
+    catch { /* empty */ }
+}
+// Format a milliseconds duration
+export function formatMilliseconds(ms, maxParts = 2) {
+    if (ms < 1)
+        return 'n/a';
+    // Split the duration into components
+    const duration = [
+        ['day', Math.floor(ms / (24 * 60 * 60 * MS))],
+        ['hour', Math.floor(ms / (60 * 60 * MS)) % 24],
+        ['minute', Math.floor(ms / (60 * MS)) % 60],
+        ['second', Math.floor(ms / MS) % 60],
+        ['millisecond', Math.floor(ms) % MS]
+    ];
+    // Remove any leading zero components
+    while (duration[0]?.[1] === 0)
+        duration.shift();
+    // Combine the required number of remaining components
+    return duration.slice(0, maxParts)
+        .filter(([_key, value]) => value !== 0)
+        .map(([key, value]) => plural(value, key))
+        .join(' ');
+}
+// Format a seconds duration
+export function formatSeconds(seconds, maxParts = 2) {
+    return formatMilliseconds(seconds * 1000, maxParts);
+}
+// Format a date as YYYYMMDD or YYYY-MM-DD
+export function formatDateISO8601(date, separator) {
+    const year = date.getUTCFullYear();
+    const month = String(date.getUTCMonth() + 1).padStart(2, '0');
+    const day = String(date.getUTCDate()).padStart(2, '0');
+    return [year, month, day].join(separator);
+}
+// Format a list (with Oxford comma)
+export function formatList(items) {
+    switch (items.length) {
+        case 0: return 'n/a';
+        case 1: return items[0] ?? '';
+        case 2: return `${items[0]} and ${items[1]}`;
+        default: return [...items.slice(0, -1), `and ${items[items.length - 1]}`].join(', ');
+    }
+}
+// Format a counted noun (handling most regular cases automatically)
+export function plural(count, noun, showCount = true) {
+    const [singular, plural] = Array.isArray(noun) ? noun : [noun, ''];
+    noun = count === 1 ? singular : plural;
+    if (!noun) {
+        // Apply regular rules
+        const rules = [
+            ['on$', 'a', 2], // phenomenon/phenomena criterion/criteria
+            ['us$', 'i', 1], //     cactus/cacti         focus/foci
+            ['[^aeiou]y$', 'ies', 1], //        cty/cites         puppy/puppies
+            ['(ch|is|o|s|sh|x|z)$', 'es', 0], //       iris/irises        truss/trusses
+            ['', 's', 0] //        cat/cats          house/houses
+        ];
+        const rule = rules.find(([ending]) => new RegExp(ending, 'i').test(singular));
+        assertIsDefined(rule);
+        const matchCase = (s) => singular === singular.toUpperCase() ? s.toUpperCase() : s;
+        noun = singular.substring(0, singular.length - rule[2]).concat(matchCase(rule[1]));
+    }
+    return showCount ? `${count} ${noun}` : noun;
+}
+// Format strings in columns
+export function columns(rows, separator = '  ') {
+    // Determine the required column widths
+    const width = [];
+    rows.forEach(row => {
+        row.forEach((value, index) => {
+            width[index] = Math.max(width[index] ?? 0, value.length);
+        });
+    });
+    width.splice(-1, 1, 0);
+    // Format the rows
+    return rows.map(row => row.map((value, index) => value.padEnd(width[index] ?? 0)).join(separator));
+}
+// Recursive object assignment, skipping undefined values
+export function deepMerge(...objects) {
+    const isObject = (value) => value !== undefined && typeof value === 'object' && !Array.isArray(value);
+    return objects.reduce((acc, object) => {
+        Object.entries(object).forEach(([key, value]) => {
+            const accValue = acc[key];
+            if (value === undefined)
+                return;
+            if (isObject(accValue) && isObject(value))
+                acc[key] = deepMerge(accValue, value);
+            else
+                acc[key] = value;
+        });
+        return acc;
+    }, {});
+}
+// Convert checker validation error into lines of text
+export function getValidationTree(errors) {
+    const lines = [];
+    errors.forEach((error, index) => {
+        const prefix = (a, b) => index < errors.length - 1 ? a : b;
+        lines.push(`${prefix('├─ ', '└─ ')}${error.path} ${error.message}`);
+        if (error.nested) {
+            const nested = getValidationTree(error.nested);
+            lines.push(...nested.map(line => `${prefix('│  ', '   ')} ${line}`));
+        }
+    });
+    return lines;
+}
+// Convert any errors in an event listener to 'error' events
+export function tryListener(emitter, op, errorHandler = (err) => emitter.emit('error', err)) {
+    return (...args) => {
+        void (async () => {
+            try {
+                await op(...args);
+            }
+            catch (err) {
+                errorHandler(err);
+            }
+        })();
+    };
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

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

package/matterbridge-dyson-robot.schema.json

@@ -0,0 +1,359 @@
+{
+    "title": "Matterbridge Dyson Robot Vacuum and Air Treatment Devices Plugin",
+    "description": "Dyson Robot Vacuum and Air Treatment Devices",
+    "type": "object",
+    "required": [
+        "devices"
+    ],
+    "properties": {
+        "name": {
+            "description": "Plugin name",
+            "type": "string",
+            "readOnly": true,
+            "ui:widget": "hidden"
+        },
+        "type": {
+            "description": "Plugin type",
+            "type": "string",
+            "readOnly": true,
+            "ui:widget": "hidden"
+        },
+        "devices": {
+            "description": "List of Dyson robot vacuum and air treatment devices to expose.",
+            "type": "array",
+            "items": {
+                "type": "object",
+                "properties": {
+                    "name": {
+                        "description": "Friendly name used to identify the robot vacuum or air treatment device. This is used as the Matter NodeLabel for the device.",
+                        "title": "e.g. Sweep",
+                        "type": "string",
+                        "minLength": 1,
+                        "maxLength": 64
+                    }
+                },
+                "required": [
+                    "name"
+                ],
+                "oneOf": [
+                    {
+                        "title": "Wi-Fi Setup Configuration",
+                        "description": "Connect to the appliance directly via the local network, deriving the MQTT configuration from the Wi-Fi setup credentials. These details can be found on a label attached to the product (behind the clear bin of robot vacuums or underneath the base of air treatment devices) or its operating manual.",
+                        "type": "object",
+                        "properties": {
+                            "host": {
+                                "$ref": "#/definitions/host"
+                            },
+                            "port": {
+                                "$ref": "#/definitions/port"
+                            },
+                            "wifi_ssid": {
+                                "description": "Product SSID from the label attached to the product or its operating manual.",
+                                "title": "e.g. DYSON-XXX-YY-ZZZZZZZZ-NNN",
+                                "type": "string",
+                                "pattern": "^(((360EYE-)?[A-Z0-9]{3}-[A-Z]{2}-[A-Z0-9]{8,})|(DYSON-[A-Z0-9]{3}-[A-Z]{2}-[A-Z0-9]{8,}-[0-9]{3}[A-Z]?))$"
+                            },
+                            "wifi_password": {
+                                "description": "Product Wi-Fi Password from the label attached to the product or its operating manual.",
+                                "title": "e.g. xxxxxxxx",
+                                "type": "string",
+                                "pattern": "^[A-Za-z0-9]{8,}$"
+                            }
+                        },
+                        "required": [
+                            "host",
+                            "port",
+                            "wifi_ssid",
+                            "wifi_password"
+                        ]
+                    },
+                    {
+                        "title": "Local MQTT Configuration",
+                        "description": "Connect to the appliance directly via the local network, providing the MQTT configuration explicitly. Use opendyson to obtain these details.",
+                        "type": "object",
+                        "properties": {
+                            "host": {
+                                "$ref": "#/definitions/host"
+                            },
+                            "port": {
+                                "$ref": "#/definitions/port"
+                            },
+                            "username": {
+                                "$ref": "#/definitions/username"
+                            },
+                            "password": {
+                                "description": "MQTT password.",
+                                "title": "From opendyson: mqtt → password",
+                                "type": "string",
+                                "pattern": "^[A-Za-z0-9+/]{86}==$"
+                            },
+                            "root_topic": {
+                                "$ref": "#/definitions/root_topic"
+                            }
+                        },
+                        "required": [
+                            "host",
+                            "port",
+                            "username",
+                            "password",
+                            "root_topic"
+                        ]
+                    },
+                    {
+                        "title": "Cloud IoT Service Configuration (do not use)",
+                        "description": "Connect to the appliance via Dyson's cloud IoT service. Use opendyson to obtain these details.",
+                        "type": "object",
+                        "properties": {
+                            "endpoint": {
+                                "description": "Cloud IoT endpoint.",
+                                "title": "From opendyson: iot → endpoint",
+                                "type": "string",
+                                "format": "hostname"
+                            },
+                            "client_id": {
+                                "description": "Cloud IoT client identifier (probably the same as the token_value).",
+                                "title": "From opendyson: iot → client_id",
+                                "type": "string",
+                                "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
+                            },
+                            "custom_authorizer_name": {
+                                "description": "Cloud IoT custom_authorizer_name.",
+                                "title": "From opendyson: iot → custom_authorizer_name",
+                                "type": "string",
+                                "pattern": "^[A-Za-z0-9-]+$"
+                            },
+                            "token_key": {
+                                "description": "Cloud IoT name of the token header.",
+                                "title": "From opendyson: iot → token_key",
+                                "type": "string",
+                                "default": "token",
+                                "pattern": "^[a-zA-Z0-9_-]+$"
+                            },
+                            "token_value": {
+                                "description": "Cloud IoT value for the token header (probably the same as the client_id).",
+                                "title": "From opendyson: iot → token_value",
+                                "type": "string",
+                                "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
+                            },
+                            "token_signature": {
+                                "description": "Cloud IoT token signature.",
+                                "title": "From opendyson: iot → token_signature",
+                                "type": "string",
+                                "pattern": "^([A-Za-z0-9+/]{4})*([A-Za-z0-9+/]{4}|[A-Za-z0-9+/]{3}=|[A-Za-z0-9+/]{2}={2})$"
+                            },
+                            "username": {
+                                "$ref": "#/definitions/username"
+                            },
+                            "root_topic": {
+                                "$ref": "#/definitions/root_topic"
+                            }
+                        },
+                        "required": [
+                            "endpoint",
+                            "client_id",
+                            "custom_authorizer_name",
+                            "token_key",
+                            "token_signature",
+                            "token_value",
+                            "root_topic"
+                        ]
+                    }
+                ]
+            },
+            "minItems": 1,
+            "uniqueItems": true
+        },
+        "wildcardTopic": {
+            "description": "Subscribe to all MQTT topics (using the '#' wildcard). This is useful for discovering new endpoints or checking that the rootTopic and username have been correctly configured. Disabling this limits subscription to the expected status topic(s).",
+            "type": "boolean",
+            "default": true
+        },
+        "whiteList": {
+            "description": "Only expose robot vacuum and air treatment devices listed here, identified by their serial number (i.e. the MQTT username). Leave empty to expose all devices.",
+            "type": "array",
+            "items": {
+                "$ref": "#/definitions/username"
+            },
+            "uniqueItems": true,
+            "selectFrom": "serial",
+            "default": []
+        },
+        "blackList": {
+            "description": "Exclude any robot vacuum and air treatment devices listed here, identified by their serial number (i.e. the MQTT username). Leave empty to expose all devices.",
+            "type": "array",
+            "items": {
+                "$ref": "#/definitions/username"
+            },
+            "uniqueItems": true,
+            "selectFrom": "serial",
+            "default": []
+        },
+        "entityWhiteList": {
+            "description": "Only expose Matter device types listed here: Air Purifier, Air Quality Sensor, Composed Air Purifier, Humidity Sensor, Temperature Sensor, or Thermostat. This applies to all air treatment devices, but does not affect robot vacuum devices. Leave empty to expose all device types.",
+            "type": "array",
+            "items": {
+                "type": "string"
+            },
+            "uniqueItems": true,
+            "selectEntityFrom": "name",
+            "default": []
+        },
+        "entityBlackList": {
+            "description": "Exclude any Matter device types listed here: Air Purifier, Air Quality Sensor, Composed Air Purifier, Humidity Sensor, Temperature Sensor, or Thermostat. This applies to all air treatment devices, but does not affect robot vacuum devices. Leave empty to expose all device types.",
+            "type": "array",
+            "items": {
+                "type": "string"
+            },
+            "uniqueItems": true,
+            "selectEntityFrom": "name",
+            "default": [
+                "Composed Air Purifier",
+                "Humidity Sensor",
+                "Temperature Sensor"
+            ]
+        },
+        "deviceEntityBlackList": {
+            "description": "Exclude Matter device types per air treatment device. This does not affect robot vacuum devices. Enter the device's serial number (i.e. the MQTT username) in the first field, and in the list add all of the device types to exclude for that device.",
+            "type": "object",
+            "uniqueItems": true,
+            "selectFrom": "serial",
+            "additionalProperties": {
+                "description": "Exclude any device types listed here.",
+                "type": "array",
+                "uniqueItems": true,
+                "items": {
+                    "type": "string"
+                },
+                "selectDeviceEntityFrom": "name"
+            }
+        },
+        "debug": {
+            "description": "Capture debug-level logging from this plugin, overriding the Matterbridge global log level setting.",
+            "type": "boolean",
+            "default": false
+        },
+        "debugFeatures": {
+            "description": "Advanced diagnostics: Enable only for troubleshooting or development.",
+            "type": "array",
+            "uniqueItems": true,
+            "items": {
+                "type": "string",
+                "enum": [
+                    "Log Endpoint Debug",
+                    "Log MQTT Client",
+                    "Log MQTT Payloads",
+                    "Log Serial Numbers",
+                    "Log Debug as Info"
+                ]
+            },
+            "default": []
+        },
+        "unregisterOnShutdown": {
+            "description": "Unregister all exposed devices on shutdown (used for development/testing).",
+            "type": "boolean",
+            "default": false,
+            "ui:widget": "hidden"
+        }
+    },
+    "definitions": {
+        "host": {
+            "description": "Local network hostname or IP address of the robot vacuum or air treatment device.",
+            "title": "e.g. sweep.local or 192.168.0.100",
+            "type": "string",
+            "format": "hostname"
+        },
+        "port": {
+            "description": "MQTT port number. This should usually be left at its default value of 1883.",
+            "title": "e.g. 1883",
+            "type": "integer",
+            "default": 1883,
+            "ui:widget": "hidden"
+        },
+        "username": {
+            "description": "MQTT username (should match the product's serial number).",
+            "title": "From opendyson: mqtt → username",
+            "type": "string",
+            "pattern": "^[A-Z0-9]{3}-[A-Z]{2}-[A-Z0-9]{8,}$"
+        },
+        "root_topic": {
+            "description": "MQTT root topic (Dyson internal product type). If using opendyson: mqtt → root_topic",
+            "title": "e.g. N223 or 475",
+            "type": "string",
+            "pattern": "^[0-9]{3}[A-Z]?$",
+            "oneOf": [
+                {
+                    "const": "N223",
+                    "title": "N223 = Dyson 360 Eye (RB01)"
+                },
+                {
+                    "const": "276",
+                    "title": "276 = Dyson 360 Heurist (RB02)"
+                },
+                {
+                    "const": "277",
+                    "title": "277 = Dyson 360 Vis Nav (RB03)"
+                },
+                {
+                    "const": "358",
+                    "title": "358 = Dyson Pure Humidify+Cool (PH01)"
+                },
+                {
+                    "const": "358E",
+                    "title": "358E = Dyson Pure Humidify+Cool (PH03)"
+                },
+                {
+                    "const": "358K",
+                    "title": "358K = Dyson Pure Humidify+Cool Formaldehyde (PH04)"
+                },
+                {
+                    "const": "438",
+                    "title": "438 = Dyson Pure Cool (TP04 or TP06)"
+                },
+                {
+                    "const": "438E",
+                    "title": "438E = Dyson Pure Cool Formaldehyde (TP07 or TP09)"
+                },
+                {
+                    "const": "438K",
+                    "title": "438K = Dyson Pure Cool Formaldehyde (TP07 or TP09)"
+                },
+                {
+                    "const": "455",
+                    "title": "455 = Dyson Pure Hot+Cool Link (HP02)"
+                },
+                {
+                    "const": "455A",
+                    "title": "455A = Dyson Pure Hot+Cool Link (HP02)"
+                },
+                {
+                    "const": "469",
+                    "title": "469 = Dyson Pure Cool Link Desk (DP01)"
+                },
+                {
+                    "const": "475",
+                    "title": "475 = Dyson Pure Cool Link (TP02)"
+                },
+                {
+                    "const": "520",
+                    "title": "520 = Dyson Pure Cool Desk (DP04)"
+                },
+                {
+                    "const": "527",
+                    "title": "527 = Dyson Pure Hot+Cool (HP04 or HP06)"
+                },
+                {
+                    "const": "527E",
+                    "title": "527E = Dyson Purifier Hot+Cool (HP07)"
+                },
+                {
+                    "const": "527K",
+                    "title": "527K = Dyson Purifier Hot+Cool Formaldehyde (HP09)"
+                },
+                {
+                    "const": "664",
+                    "title": "664 = Dyson Purifier Big+Quiet Series (BP02, BP03, BP04, or BP06)"
+                }
+            ]
+        }
+    }
+}