yoto-nodejs-client 0.0.3 → 0.0.5

package/README.md

@@ -1144,7 +1144,7 @@ yoto-devices --device-id abc123 --mqtt --mqtt-timeout 10
 # Use YotoDeviceModel to monitor device (HTTP + MQTT)
 yoto-device-model --device-id abc123
 
-# Interactive TUI for device control (Prototype/WIP)
+# Interactive TUI for device control (Prototype/WIP/Unpublished)
 yoto-device-tui --device-id abc123
 ```
 

package/bin/devices.js

@@ -165,6 +165,40 @@ async function main () {
         accessToken
       })
 
+      // Setup interactive keyboard input (once, before connecting)
+      readline.emitKeypressEvents(process.stdin)
+      if (process.stdin.isTTY) {
+        process.stdin.setRawMode(true)
+      }
+
+      process.stdin.on('keypress', (_str, key) => {
+        if (key.ctrl && key.name === 'c') {
+          cleanup()
+          return
+        }
+
+        if (key.name === 's') {
+          const requestId = `interactive-${Date.now()}`
+          console.log(`\n⌨️  Requesting status [${requestId}]...`)
+          mqttClient.requestStatus(requestId).catch(err => {
+            console.error('⚠️  Failed to request status:', err.message)
+          })
+        } else if (key.name === 'e') {
+          const requestId = `interactive-${Date.now()}`
+          console.log(`\n⌨️  Requesting events [${requestId}]...`)
+          mqttClient.requestEvents(requestId).catch(err => {
+            console.error('⚠️  Failed to request events:', err.message)
+          })
+        } else if (key.name === 'return') {
+          const timestamp = new Date().toISOString()
+          console.log(`\n${'─'.repeat(60)}`)
+          console.log(`📍 MARKER [${timestamp}]`)
+          console.log(`${'─'.repeat(60)}\n`)
+        } else if (key.name === 'q') {
+          cleanup()
+        }
+      })
+
       // Setup message handlers
       mqttClient.on('connected', () => {
         console.log('✅ Connected to MQTT broker')
@@ -211,40 +245,6 @@ async function main () {
         }
 
         console.log() // Add blank line for spacing
-
-        // Setup interactive keyboard input
-        readline.emitKeypressEvents(process.stdin)
-        if (process.stdin.isTTY) {
-          process.stdin.setRawMode(true)
-        }
-
-        process.stdin.on('keypress', (_str, key) => {
-          if (key.ctrl && key.name === 'c') {
-            cleanup()
-            return
-          }
-
-          if (key.name === 's') {
-            const requestId = `interactive-${Date.now()}`
-            console.log(`\n⌨️  Requesting status [${requestId}]...`)
-            mqttClient.requestStatus(requestId).catch(err => {
-              console.error('⚠️  Failed to request status:', err.message)
-            })
-          } else if (key.name === 'e') {
-            const requestId = `interactive-${Date.now()}`
-            console.log(`\n⌨️  Requesting events [${requestId}]...`)
-            mqttClient.requestEvents(requestId).catch(err => {
-              console.error('⚠️  Failed to request events:', err.message)
-            })
-          } else if (key.name === 'return') {
-            const timestamp = new Date().toISOString()
-            console.log(`\n${'─'.repeat(60)}`)
-            console.log(`📍 MARKER [${timestamp}]`)
-            console.log(`${'─'.repeat(60)}\n`)
-          } else if (key.name === 'q') {
-            cleanup()
-          }
-        })
       })
 
       mqttClient.on('events', (topic, payload) => {

package/lib/mqtt/client.d.ts

@@ -370,15 +370,15 @@ export type YotoMqttStatus = {
      */
     headphones: boolean;
     /**
-     * - Current display brightness
+     * - Current display brightness (Integer 0-100)
      */
     dnowBrightness: number;
     /**
-     * - Day brightness setting
+     * - Day brightness setting (Integer 0-100)
      */
     dayBright: number;
     /**
-     * - Night brightness setting
+     * - Night brightness setting (Integer 0-100)
      */
     nightBright: number;
     /**

package/lib/mqtt/client.js

@@ -70,9 +70,9 @@
  * @property {0 | 1 | 2} cardInserted - Card insertion state (0=none, 1=physical, 2=remote)
  * @property {number} playingStatus - Playing status code
  * @property {boolean} headphones - Headphones connected
- * @property {number} dnowBrightness - Current display brightness
- * @property {number} dayBright - Day brightness setting
- * @property {number} nightBright - Night brightness setting
+ * @property {number} dnowBrightness - Current display brightness (Integer 0-100)
+ * @property {number} dayBright - Day brightness setting (Integer 0-100)
+ * @property {number} nightBright - Night brightness setting (Integer 0-100)
  * @property {boolean} bluetoothHp - Bluetooth headphones enabled
  * @property {number} volume - System/max volume level (0-100 percentage, represents 0-16 hardware scale, maps to volumeMax in events)
  * @property {number} userVolume - User volume setting (0-100 percentage, represents 0-16 hardware scale, maps to volume in events)

package/lib/pkg.d.cts

@@ -7,12 +7,12 @@ export const pkg: {
         url: string;
     };
     dependencies: {
-        "@unblessed/node": string;
         "jwt-decode": string;
         mqtt: string;
         undici: string;
     };
     devDependencies: {
+        "@unblessed/node": string;
         "@types/node": string;
         "@voxpelli/tsconfig": string;
         argsclopts: string;
@@ -42,7 +42,6 @@ export const pkg: {
         "yoto-refresh-token": string;
         "yoto-devices": string;
         "yoto-device-model": string;
-        "yoto-device-tui": string;
         "yoto-content": string;
         "yoto-groups": string;
         "yoto-icons": string;

package/lib/yoto-device.d.ts

@@ -51,7 +51,7 @@ export const NIGHTLIGHT_COLORS: {
  * @property {string} nightlightMode - Current nightlight color (6-digit hex color like '0xff5733' or 'off'). Most accurate value comes from MQTT status. HTTP endpoint returns either 'off' or '0x000000'. Note: This is the live status; configured colors are in config.ambientColour (day) and config.nightAmbientColour (night). Only available on devices with colored nightlight (v3).
  * @property {string | number | null} temperatureCelsius - Temperature in Celsius (null if not supported, can be number, string "0", or "notSupported") TODO: Number or null only
  * @property {number} ambientLightSensorReading - Ambient light sensor reading TODO: Figure out units
- * @property {number | null} displayBrightness - Current display brightness (null when device is off) - from YotoDeviceFullStatus (dnowBrightness) TODO: Figure out units
+ * @property {number | null} displayBrightness - Current display brightness (null when device is off) - from YotoDeviceFullStatus (dnowBrightness integer 0-100)
  * @property {'12' | '24' | null} timeFormat - Time format preference - from YotoDeviceFullStatus
  * @property {number} uptime - Device uptime in seconds
  * @property {string} updatedAt - ISO 8601 timestamp of last update
@@ -392,7 +392,7 @@ export type YotoDeviceStatus = {
      */
     ambientLightSensorReading: number;
     /**
-     * - Current display brightness (null when device is off) - from YotoDeviceFullStatus (dnowBrightness) TODO: Figure out units
+     * - Current display brightness (null when device is off) - from YotoDeviceFullStatus (dnowBrightness integer 0-100)
      */
     displayBrightness: number | null;
     /**

package/lib/yoto-device.js

@@ -133,7 +133,7 @@ export function getNightlightColorName (colorValue) {
  * @property {string} nightlightMode - Current nightlight color (6-digit hex color like '0xff5733' or 'off'). Most accurate value comes from MQTT status. HTTP endpoint returns either 'off' or '0x000000'. Note: This is the live status; configured colors are in config.ambientColour (day) and config.nightAmbientColour (night). Only available on devices with colored nightlight (v3).
  * @property {string | number | null} temperatureCelsius - Temperature in Celsius (null if not supported, can be number, string "0", or "notSupported") TODO: Number or null only
  * @property {number} ambientLightSensorReading - Ambient light sensor reading TODO: Figure out units
- * @property {number | null} displayBrightness - Current display brightness (null when device is off) - from YotoDeviceFullStatus (dnowBrightness) TODO: Figure out units
+ * @property {number | null} displayBrightness - Current display brightness (null when device is off) - from YotoDeviceFullStatus (dnowBrightness integer 0-100)
  * @property {'12' | '24' | null} timeFormat - Time format preference - from YotoDeviceFullStatus
  * @property {number} uptime - Device uptime in seconds
  * @property {string} updatedAt - ISO 8601 timestamp of last update

package/package.json

@@ -1,18 +1,18 @@
 {
   "name": "yoto-nodejs-client",
   "description": "(Unofficial) Node.js client for the Yoto API with automatic token refresh, MQTT device communication, and TypeScript support",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "author": "Bret Comnes <bcomnes@gmail.com> (https://bret.io)",
   "bugs": {
     "url": "https://github.com/bcomnes/yoto-nodejs-client/issues"
   },
   "dependencies": {
-    "@unblessed/node": "1.0.0-alpha.23",
     "jwt-decode": "^4.0.0",
     "mqtt": "^5.14.1",
     "undici": "^7.16.0"
   },
   "devDependencies": {
+    "@unblessed/node": "1.0.0-alpha.23",
     "@types/node": "^25.0.0",
     "@voxpelli/tsconfig": "^16.1.0",
     "argsclopts": "^1.0.5",
@@ -61,7 +61,6 @@
     "yoto-refresh-token": "./bin/refresh-token.js",
     "yoto-devices": "./bin/devices.js",
     "yoto-device-model": "./bin/device-model.js",
-    "yoto-device-tui": "./bin/device-tui.js",
     "yoto-content": "./bin/content.js",
     "yoto-groups": "./bin/groups.js",
     "yoto-icons": "./bin/icons.js"