yoto-nodejs-client 0.0.2 → 0.0.3

package/lib/api-endpoints/devices.d.ts

@@ -37,38 +37,38 @@ export function getDevices({ accessToken, userAgent, requestOptions }: {
  * @see https://yoto.dev/api/getdevicestatus/
  * @typedef {Object} YotoDeviceStatusResponse
  * @property {string} deviceId - Unique identifier of the device
- * @property {string} [activeCard] - Active card on the device (can be 'none')
- * @property {number} [ambientLightSensorReading] - Reading from ambient light sensor
- * @property {number} [averageDownloadSpeedBytesSecond] - Average download speed in bytes per second
- * @property {number} [batteryLevelPercentage] - Battery level in percentage
- * @property {number} [batteryLevelPercentageRaw] - Raw battery level percentage
- * @property {number} [buzzErrors] - Number of buzz errors
- * @property {0 | 1 | 2} [cardInsertionState] - Card insertion state (0=none, 1=physical, 2=remote)
- * @property {-1 | 0 | 1} [dayMode] - Day mode status (-1=unknown, 0=night, 1=day)
- * @property {number} [errorsLogged] - Number of errors logged
- * @property {string} [firmwareVersion] - Firmware version (e.g., 'v2.23.2')
- * @property {number} [freeDiskSpaceBytes] - Free disk space in bytes
- * @property {boolean} [isAudioDeviceConnected] - Whether audio device is connected
- * @property {boolean} [isBackgroundDownloadActive] - Whether background download is active
- * @property {boolean} [isBluetoothAudioConnected] - Whether Bluetooth audio is connected
- * @property {boolean} [isCharging] - Whether device is currently charging
- * @property {number} [isNfcLocked] - NFC lock status
- * @property {boolean} [isOnline] - Whether device is currently online
- * @property {string} [networkSsid] - Network SSID device is connected to
- * @property {string} [nightlightMode] - Nightlight mode (hex code or 'off')
- * @property {number} [playingSource] - Currently playing source
- * @property {string | null} [powerCapabilities] - Power capabilities (e.g., '0x02')
- * @property {0 | 1 | 2 | 3} [powerSource] - Power source (0=battery, 1=V2 dock, 2=USB-C, 3=Qi)
- * @property {number} [systemVolumePercentage] - System volume in percentage
- * @property {number} [taskWatchdogTimeoutCount] - Task watchdog timeout count
- * @property {number | string} [temperatureCelcius] - Temperature in Celsius (can be number, string like "0", or "notSupported")
- * @property {number} [totalDiskSpaceBytes] - Total disk space in bytes
- * @property {string} [updatedAt] - Timestamp of last update
- * @property {number} [uptime] - Uptime of the device in seconds
- * @property {number} [userVolumePercentage] - User volume in percentage
- * @property {number} [utcOffsetSeconds] - UTC offset in seconds
- * @property {number} [utcTime] - UTC time as Unix timestamp
- * @property {number} [wifiStrength] - WiFi connection strength in decibels
+ * @property {string} activeCard - Active card on the device (can be 'none')
+ * @property {number} ambientLightSensorReading - Reading from ambient light sensor
+ * @property {number} averageDownloadSpeedBytesSecond - Average download speed in bytes per second
+ * @property {number} batteryLevelPercentage - Battery level in percentage
+ * @property {number} batteryLevelPercentageRaw - Raw battery level percentage
+ * @property {number} buzzErrors - Number of buzz errors
+ * @property {0 | 1 | 2} cardInsertionState - Card insertion state from API (0=none, 1=physical, 2=remote) - converted to CardInsertionState string union in YotoDeviceStatus
+ * @property {-1 | 0 | 1} dayMode - Day mode status (-1=unknown, 0=night, 1=day)
+ * @property {number} errorsLogged - Number of errors logged
+ * @property {string} firmwareVersion - Firmware version (e.g., 'v2.23.2')
+ * @property {number} freeDiskSpaceBytes - Free disk space in bytes
+ * @property {boolean} isAudioDeviceConnected - Whether audio device is connected
+ * @property {boolean} isBackgroundDownloadActive - Whether background download is active
+ * @property {boolean} isBluetoothAudioConnected - Whether Bluetooth audio is connected
+ * @property {boolean} isCharging - Whether device is currently charging
+ * @property {number} isNfcLocked - NFC lock status
+ * @property {boolean} isOnline - Whether device is currently online
+ * @property {string} networkSsid - Network SSID device is connected to
+ * @property {string} nightlightMode - Current nightlight color (HTTP returns 'off' or '0x000000'; MQTT provides actual hex color like '0xff5733')
+ * @property {number} playingSource - Currently playing source
+ * @property {string | null} powerCapabilities - Power capabilities (e.g., '0x02')
+ * @property {0 | 1 | 2 | 3} powerSource - Power source (0=battery, 1=V2 dock, 2=USB-C, 3=Qi)
+ * @property {number} systemVolumePercentage - System/max volume in percentage (0-100, represents 0-16 hardware scale, maps to volumeMax in events)
+ * @property {number} taskWatchdogTimeoutCount - Task watchdog timeout count
+ * @property {string | number} temperatureCelcius - Temperature in Celsius (can be number or string like "0" or "notSupported") - Note: API misspells "Celsius"
+ * @property {number} totalDiskSpaceBytes - Total disk space in bytes
+ * @property {string} updatedAt - Timestamp of last update
+ * @property {number} uptime - Uptime of the device in seconds
+ * @property {number} userVolumePercentage - User volume in percentage (0-100, represents 0-16 hardware scale, maps to volume in events)
+ * @property {number} utcOffsetSeconds - UTC offset in seconds
+ * @property {number} utcTime - UTC time as Unix timestamp
+ * @property {number} wifiStrength - WiFi connection strength in decibels
  */
 /**
  * Retrieves the current status of a specific device.
@@ -113,44 +113,105 @@ export function getDeviceStatus({ accessToken, userAgent, deviceId, requestOptio
  * @property {string} releaseChannelId - Release channel identifier
  * @property {string} releaseChannelVersion - Release channel version
  * @property {string} fwVersion - Firmware version (undocumented)
- * @property {any} [status] - Device status object (undocumented)
- * @property {YotoDeviceShortcuts} [shortcuts] - Button shortcuts configuration (beta feature)
+ * @property {YotoDeviceFullStatus} status - Comprehensive device status object (undocumented)
+ * @property {YotoDeviceShortcuts} shortcuts - Button shortcuts configuration (beta feature)
+ */
+/**
+ * Comprehensive device status from HTTP config endpoint (undocumented)
+ * Contains both user-facing fields and low-level hardware/diagnostic data
+ * Note: Many fields are nullable when device hasn't synced settings yet
+ * @typedef {Object} YotoDeviceFullStatus
+ * @property {string} activeCard - Active card ID or 'none'
+ * @property {number | null} aliveTime - Total time device has been alive
+ * @property {number} als - Ambient light sensor reading
+ * @property {number | null} battery - Raw battery voltage
+ * @property {number} batteryLevel - Battery level percentage
+ * @property {number} batteryLevelRaw - Raw battery level percentage
+ * @property {number | null} batteryRemaining - Battery remaining time estimate
+ * @property {0 | 1} bgDownload - Background download status (0 or 1)
+ * @property {0 | 1} bluetoothHp - Bluetooth headphones enabled (0 or 1)
+ * @property {number} buzzErrors - Number of buzz errors
+ * @property {number} bytesPS - Bytes per second transfer rate
+ * @property {0 | 1 | 2} cardInserted - Card insertion state (0=none, 1=physical, 2=remote)
+ * @property {number | null} chgStatLevel - Charge state level
+ * @property {0 | 1} charging - Charging state (0 or 1)
+ * @property {-1 | 0 | 1} day - Day mode (0=night, 1=day, -1=unknown)
+ * @property {number | null} dayBright - Day brightness setting
+ * @property {number | null} dbatTimeout - DBAT timeout value
+ * @property {string} deviceId - Device unique identifier
+ * @property {number | null} dnowBrightness - Current display brightness
+ * @property {number} errorsLogged - Number of errors logged
+ * @property {any} failData - Failure data (null if none)
+ * @property {any} failReason - Failure reason (null if none)
+ * @property {number | null} free - Free memory in bytes
+ * @property {number | null} free32 - Free 32-bit memory pool
+ * @property {number} freeDisk - Free disk space in bytes
+ * @property {number | null} freeDMA - Free DMA memory
+ * @property {string} fwVersion - Firmware version
+ * @property {0 | 1} headphones - Headphones connected (0 or 1)
+ * @property {string | null} lastSeenAt - Last seen timestamp
+ * @property {number | null} missedLogs - Number of missed log entries
+ * @property {string} nfcErrs - NFC errors (e.g., 'n/a')
+ * @property {number} nfcLock - NFC lock status
+ * @property {number | null} nightBright - Night brightness setting
+ * @property {string} nightlightMode - Current nightlight color (hex color like '0xff5733' or 'off')
+ * @property {number} playingStatus - Playing status code
+ * @property {string | null} powerCaps - Power capabilities
+ * @property {0 | 1 | 2 | 3} powerSrc - Power source (0=battery, 1=V2 dock, 2=USB-C, 3=Qi)
+ * @property {number | null} qiOtp - Qi OTP value
+ * @property {string | null} sd_info - SD card information
+ * @property {string | null} shutDown - Shutdown reason ('nA' = running, 'userShutdown' = powered off, etc.)
+ * @property {number | null} shutdownTimeout - Shutdown timeout in seconds
+ * @property {string} ssid - WiFi SSID
+ * @property {number | null} statusVersion - Status version number
+ * @property {string} temp - Temperature readings (format: 'value1:value2' or 'value1:notSupported')
+ * @property {'12' | '24' | null} timeFormat - Time format ('12' or '24')
+ * @property {number} totalDisk - Total disk space in bytes
+ * @property {number} twdt - Task watchdog timeout count
+ * @property {string} updatedAt - Last update timestamp (ISO 8601)
+ * @property {number} upTime - Uptime in seconds
+ * @property {number} userVolume - User volume setting (0-100 percentage, represents 0-16 hardware scale, maps to volume in events)
+ * @property {number} utcOffset - UTC offset in seconds
+ * @property {number} utcTime - UTC time as Unix timestamp
+ * @property {number} volume - System/max volume level (0-100 percentage, represents 0-16 hardware scale, maps to volumeMax in events)
+ * @property {number | null} wifiRestarts - Number of WiFi restarts
+ * @property {number} wifiStrength - WiFi signal strength in dBm
  */
 /**
  * @see https://yoto.dev/api/getdeviceconfig/
  * @typedef {Object} YotoDeviceConfig
- * @property {string[]} [alarms] - Array of alarm strings in comma-separated format (e.g., '1111111,1100,5WsQg,,,8')
+ * @property {string[]} alarms - Array of alarm strings in comma-separated format (e.g., '1111111,1100,5WsQg,,,8')
  * @property {string} ambientColour - Ambient light color (hex code)
  * @property {string} bluetoothEnabled - Bluetooth enabled state ('0' or '1')
  * @property {boolean} btHeadphonesEnabled - Bluetooth headphones enabled
- * @property {string} [clockFace] - Clock face style (e.g., 'digital-sun')
- * @property {string} dayDisplayBrightness - Day display brightness (e.g., 'auto')
- * @property {string} dayTime - Day mode start time (e.g., '07:30')
+ * @property {string} clockFace - Clock face style (e.g., 'digital-sun')
+ * @property {string} dayDisplayBrightness - Day display brightness (e.g., 'auto', '100')
+ * @property {string} dayTime - Day mode start time (e.g., '07:00')
  * @property {string} dayYotoDaily - Day mode Yoto Daily card path
  * @property {string} dayYotoRadio - Day mode Yoto Radio card path
- * @property {string} [daySoundsOff] - Day sounds off setting (undocumented)
- * @property {string} [displayDimBrightness] - Display dim brightness level
+ * @property {string} daySoundsOff - Day sounds off setting ('0' or '1') (undocumented)
+ * @property {string} displayDimBrightness - Display dim brightness level (undocumented)
  * @property {string} displayDimTimeout - Display dim timeout in seconds
  * @property {boolean} headphonesVolumeLimited - Whether headphones volume is limited
- * @property {string} [hourFormat] - Hour format ('12' or '24')
- * @property {string} [logLevel] - Log level (e.g., 'none') (undocumented)
- * @property {string} [locale] - Device locale (e.g., 'en') (undocumented)
+ * @property {string} hourFormat - Hour format ('12' or '24') (undocumented)
+ * @property {string} logLevel - Log level (e.g., 'none') (undocumented)
+ * @property {string} locale - Device locale (e.g., 'en') (undocumented)
  * @property {string} maxVolumeLimit - Maximum volume limit
  * @property {string} nightAmbientColour - Night ambient light color (hex code)
  * @property {string} nightDisplayBrightness - Night display brightness
  * @property {string} nightMaxVolumeLimit - Night maximum volume limit
- * @property {string} nightTime - Night mode start time (e.g., '19:30')
+ * @property {string} nightTime - Night mode start time (e.g., '19:20')
  * @property {string} nightYotoDaily - Night mode Yoto Daily card path
- * @property {string} nightYotoRadio - Night mode Yoto Radio card path
- * @property {string} [nightSoundsOff] - Night sounds off setting (undocumented)
- * @property {boolean} [pausePowerButton] - Pause on power button press (undocumented)
- * @property {boolean} [pauseVolumeDown] - Pause on volume down (undocumented)
+ * @property {string} nightYotoRadio - Night mode Yoto Radio card path (can be '0' for none)
+ * @property {string} nightSoundsOff - Night sounds off setting ('0' or '1') (undocumented)
+ * @property {boolean} pausePowerButton - Pause on power button press (undocumented)
+ * @property {boolean} pauseVolumeDown - Pause on volume down (undocumented)
  * @property {boolean} repeatAll - Whether repeat all is enabled
- * @property {boolean} [showDiagnostics] - Show diagnostics (undocumented)
+ * @property {boolean} showDiagnostics - Show diagnostics (undocumented)
  * @property {string} shutdownTimeout - Shutdown timeout in seconds
- * @property {string} [systemVolume] - System volume level (undocumented)
- * @property {string} [timezone] - Timezone setting (undocumented)
- * @property {string} [volumeLevel] - Volume level preset (e.g., 'safe')
+ * @property {string} systemVolume - System volume level (e.g., '100') (undocumented)
+ * @property {string} timezone - Timezone setting (empty string if not set) (undocumented)
+ * @property {string} volumeLevel - Volume level preset (e.g., 'safe') (undocumented)
  */
 /**
  * @see https://yoto.dev/api/getdeviceconfig/
@@ -348,131 +409,131 @@ export type YotoDeviceStatusResponse = {
     /**
      * - Active card on the device (can be 'none')
      */
-    activeCard?: string;
+    activeCard: string;
     /**
      * - Reading from ambient light sensor
      */
-    ambientLightSensorReading?: number;
+    ambientLightSensorReading: number;
     /**
      * - Average download speed in bytes per second
      */
-    averageDownloadSpeedBytesSecond?: number;
+    averageDownloadSpeedBytesSecond: number;
     /**
      * - Battery level in percentage
      */
-    batteryLevelPercentage?: number;
+    batteryLevelPercentage: number;
     /**
      * - Raw battery level percentage
      */
-    batteryLevelPercentageRaw?: number;
+    batteryLevelPercentageRaw: number;
     /**
      * - Number of buzz errors
      */
-    buzzErrors?: number;
+    buzzErrors: number;
     /**
-     * - Card insertion state (0=none, 1=physical, 2=remote)
+     * - Card insertion state from API (0=none, 1=physical, 2=remote) - converted to CardInsertionState string union in YotoDeviceStatus
      */
-    cardInsertionState?: 0 | 1 | 2;
+    cardInsertionState: 0 | 1 | 2;
     /**
      * - Day mode status (-1=unknown, 0=night, 1=day)
      */
-    dayMode?: -1 | 0 | 1;
+    dayMode: -1 | 0 | 1;
     /**
      * - Number of errors logged
      */
-    errorsLogged?: number;
+    errorsLogged: number;
     /**
      * - Firmware version (e.g., 'v2.23.2')
      */
-    firmwareVersion?: string;
+    firmwareVersion: string;
     /**
      * - Free disk space in bytes
      */
-    freeDiskSpaceBytes?: number;
+    freeDiskSpaceBytes: number;
     /**
      * - Whether audio device is connected
      */
-    isAudioDeviceConnected?: boolean;
+    isAudioDeviceConnected: boolean;
     /**
      * - Whether background download is active
      */
-    isBackgroundDownloadActive?: boolean;
+    isBackgroundDownloadActive: boolean;
     /**
      * - Whether Bluetooth audio is connected
      */
-    isBluetoothAudioConnected?: boolean;
+    isBluetoothAudioConnected: boolean;
     /**
      * - Whether device is currently charging
      */
-    isCharging?: boolean;
+    isCharging: boolean;
     /**
      * - NFC lock status
      */
-    isNfcLocked?: number;
+    isNfcLocked: number;
     /**
      * - Whether device is currently online
      */
-    isOnline?: boolean;
+    isOnline: boolean;
     /**
      * - Network SSID device is connected to
      */
-    networkSsid?: string;
+    networkSsid: string;
     /**
-     * - Nightlight mode (hex code or 'off')
+     * - Current nightlight color (HTTP returns 'off' or '0x000000'; MQTT provides actual hex color like '0xff5733')
      */
-    nightlightMode?: string;
+    nightlightMode: string;
     /**
      * - Currently playing source
      */
-    playingSource?: number;
+    playingSource: number;
     /**
      * - Power capabilities (e.g., '0x02')
      */
-    powerCapabilities?: string | null;
+    powerCapabilities: string | null;
     /**
      * - Power source (0=battery, 1=V2 dock, 2=USB-C, 3=Qi)
      */
-    powerSource?: 0 | 1 | 2 | 3;
+    powerSource: 0 | 1 | 2 | 3;
     /**
-     * - System volume in percentage
+     * - System/max volume in percentage (0-100, represents 0-16 hardware scale, maps to volumeMax in events)
      */
-    systemVolumePercentage?: number;
+    systemVolumePercentage: number;
     /**
      * - Task watchdog timeout count
      */
-    taskWatchdogTimeoutCount?: number;
+    taskWatchdogTimeoutCount: number;
     /**
-     * - Temperature in Celsius (can be number, string like "0", or "notSupported")
+     * - Temperature in Celsius (can be number or string like "0" or "notSupported") - Note: API misspells "Celsius"
      */
-    temperatureCelcius?: number | string;
+    temperatureCelcius: string | number;
     /**
      * - Total disk space in bytes
      */
-    totalDiskSpaceBytes?: number;
+    totalDiskSpaceBytes: number;
     /**
      * - Timestamp of last update
      */
-    updatedAt?: string;
+    updatedAt: string;
     /**
      * - Uptime of the device in seconds
      */
-    uptime?: number;
+    uptime: number;
     /**
-     * - User volume in percentage
+     * - User volume in percentage (0-100, represents 0-16 hardware scale, maps to volume in events)
      */
-    userVolumePercentage?: number;
+    userVolumePercentage: number;
     /**
      * - UTC offset in seconds
      */
-    utcOffsetSeconds?: number;
+    utcOffsetSeconds: number;
     /**
      * - UTC time as Unix timestamp
      */
-    utcTime?: number;
+    utcTime: number;
     /**
      * - WiFi connection strength in decibels
      */
-    wifiStrength?: number;
+    wifiStrength: number;
 };
 export type YotoDeviceConfigResponse = {
     device: YotoDeviceConfigDevice;
@@ -547,19 +608,246 @@ export type YotoDeviceConfigDevice = {
      */
     fwVersion: string;
     /**
-     * - Device status object (undocumented)
+     * - Comprehensive device status object (undocumented)
      */
-    status?: any;
+    status: YotoDeviceFullStatus;
     /**
      * - Button shortcuts configuration (beta feature)
      */
-    shortcuts?: YotoDeviceShortcuts;
+    shortcuts: YotoDeviceShortcuts;
+};
+/**
+ * Comprehensive device status from HTTP config endpoint (undocumented)
+ * Contains both user-facing fields and low-level hardware/diagnostic data
+ * Note: Many fields are nullable when device hasn't synced settings yet
+ */
+export type YotoDeviceFullStatus = {
+    /**
+     * - Active card ID or 'none'
+     */
+    activeCard: string;
+    /**
+     * - Total time device has been alive
+     */
+    aliveTime: number | null;
+    /**
+     * - Ambient light sensor reading
+     */
+    als: number;
+    /**
+     * - Raw battery voltage
+     */
+    battery: number | null;
+    /**
+     * - Battery level percentage
+     */
+    batteryLevel: number;
+    /**
+     * - Raw battery level percentage
+     */
+    batteryLevelRaw: number;
+    /**
+     * - Battery remaining time estimate
+     */
+    batteryRemaining: number | null;
+    /**
+     * - Background download status (0 or 1)
+     */
+    bgDownload: 0 | 1;
+    /**
+     * - Bluetooth headphones enabled (0 or 1)
+     */
+    bluetoothHp: 0 | 1;
+    /**
+     * - Number of buzz errors
+     */
+    buzzErrors: number;
+    /**
+     * - Bytes per second transfer rate
+     */
+    bytesPS: number;
+    /**
+     * - Card insertion state (0=none, 1=physical, 2=remote)
+     */
+    cardInserted: 0 | 1 | 2;
+    /**
+     * - Charge state level
+     */
+    chgStatLevel: number | null;
+    /**
+     * - Charging state (0 or 1)
+     */
+    charging: 0 | 1;
+    /**
+     * - Day mode (0=night, 1=day, -1=unknown)
+     */
+    day: -1 | 0 | 1;
+    /**
+     * - Day brightness setting
+     */
+    dayBright: number | null;
+    /**
+     * - DBAT timeout value
+     */
+    dbatTimeout: number | null;
+    /**
+     * - Device unique identifier
+     */
+    deviceId: string;
+    /**
+     * - Current display brightness
+     */
+    dnowBrightness: number | null;
+    /**
+     * - Number of errors logged
+     */
+    errorsLogged: number;
+    /**
+     * - Failure data (null if none)
+     */
+    failData: any;
+    /**
+     * - Failure reason (null if none)
+     */
+    failReason: any;
+    /**
+     * - Free memory in bytes
+     */
+    free: number | null;
+    /**
+     * - Free 32-bit memory pool
+     */
+    free32: number | null;
+    /**
+     * - Free disk space in bytes
+     */
+    freeDisk: number;
+    /**
+     * - Free DMA memory
+     */
+    freeDMA: number | null;
+    /**
+     * - Firmware version
+     */
+    fwVersion: string;
+    /**
+     * - Headphones connected (0 or 1)
+     */
+    headphones: 0 | 1;
+    /**
+     * - Last seen timestamp
+     */
+    lastSeenAt: string | null;
+    /**
+     * - Number of missed log entries
+     */
+    missedLogs: number | null;
+    /**
+     * - NFC errors (e.g., 'n/a')
+     */
+    nfcErrs: string;
+    /**
+     * - NFC lock status
+     */
+    nfcLock: number;
+    /**
+     * - Night brightness setting
+     */
+    nightBright: number | null;
+    /**
+     * - Current nightlight color (hex color like '0xff5733' or 'off')
+     */
+    nightlightMode: string;
+    /**
+     * - Playing status code
+     */
+    playingStatus: number;
+    /**
+     * - Power capabilities
+     */
+    powerCaps: string | null;
+    /**
+     * - Power source (0=battery, 1=V2 dock, 2=USB-C, 3=Qi)
+     */
+    powerSrc: 0 | 1 | 2 | 3;
+    /**
+     * - Qi OTP value
+     */
+    qiOtp: number | null;
+    /**
+     * - SD card information
+     */
+    sd_info: string | null;
+    /**
+     * - Shutdown reason ('nA' = running, 'userShutdown' = powered off, etc.)
+     */
+    shutDown: string | null;
+    /**
+     * - Shutdown timeout in seconds
+     */
+    shutdownTimeout: number | null;
+    /**
+     * - WiFi SSID
+     */
+    ssid: string;
+    /**
+     * - Status version number
+     */
+    statusVersion: number | null;
+    /**
+     * - Temperature readings (format: 'value1:value2' or 'value1:notSupported')
+     */
+    temp: string;
+    /**
+     * - Time format ('12' or '24')
+     */
+    timeFormat: "12" | "24" | null;
+    /**
+     * - Total disk space in bytes
+     */
+    totalDisk: number;
+    /**
+     * - Task watchdog timeout count
+     */
+    twdt: number;
+    /**
+     * - Last update timestamp (ISO 8601)
+     */
+    updatedAt: string;
+    /**
+     * - Uptime in seconds
+     */
+    upTime: number;
+    /**
+     * - User volume setting (0-100 percentage, represents 0-16 hardware scale, maps to volume in events)
+     */
+    userVolume: number;
+    /**
+     * - UTC offset in seconds
+     */
+    utcOffset: number;
+    /**
+     * - UTC time as Unix timestamp
+     */
+    utcTime: number;
+    /**
+     * - System/max volume level (0-100 percentage, represents 0-16 hardware scale, maps to volumeMax in events)
+     */
+    volume: number;
+    /**
+     * - Number of WiFi restarts
+     */
+    wifiRestarts: number | null;
+    /**
+     * - WiFi signal strength in dBm
+     */
+    wifiStrength: number;
 };
 export type YotoDeviceConfig = {
     /**
      * - Array of alarm strings in comma-separated format (e.g., '1111111,1100,5WsQg,,,8')
      */
-    alarms?: string[];
+    alarms: string[];
     /**
      * - Ambient light color (hex code)
      */
@@ -575,13 +863,13 @@ export type YotoDeviceConfig = {
     /**
      * - Clock face style (e.g., 'digital-sun')
      */
-    clockFace?: string;
+    clockFace: string;
     /**
-     * - Day display brightness (e.g., 'auto')
+     * - Day display brightness (e.g., 'auto', '100')
      */
     dayDisplayBrightness: string;
     /**
-     * - Day mode start time (e.g., '07:30')
+     * - Day mode start time (e.g., '07:00')
      */
     dayTime: string;
     /**
@@ -593,13 +881,13 @@ export type YotoDeviceConfig = {
      */
     dayYotoRadio: string;
     /**
-     * - Day sounds off setting (undocumented)
+     * - Day sounds off setting ('0' or '1') (undocumented)
      */
-    daySoundsOff?: string;
+    daySoundsOff: string;
     /**
-     * - Display dim brightness level
+     * - Display dim brightness level (undocumented)
      */
-    displayDimBrightness?: string;
+    displayDimBrightness: string;
     /**
      * - Display dim timeout in seconds
      */
@@ -609,17 +897,17 @@ export type YotoDeviceConfig = {
      */
     headphonesVolumeLimited: boolean;
     /**
-     * - Hour format ('12' or '24')
+     * - Hour format ('12' or '24') (undocumented)
      */
-    hourFormat?: string;
+    hourFormat: string;
     /**
      * - Log level (e.g., 'none') (undocumented)
      */
-    logLevel?: string;
+    logLevel: string;
     /**
      * - Device locale (e.g., 'en') (undocumented)
      */
-    locale?: string;
+    locale: string;
     /**
      * - Maximum volume limit
      */
@@ -637,7 +925,7 @@ export type YotoDeviceConfig = {
      */
     nightMaxVolumeLimit: string;
     /**
-     * - Night mode start time (e.g., '19:30')
+     * - Night mode start time (e.g., '19:20')
      */
     nightTime: string;
     /**
@@ -645,21 +933,21 @@ export type YotoDeviceConfig = {
      */
     nightYotoDaily: string;
     /**
-     * - Night mode Yoto Radio card path
+     * - Night mode Yoto Radio card path (can be '0' for none)
      */
     nightYotoRadio: string;
     /**
-     * - Night sounds off setting (undocumented)
+     * - Night sounds off setting ('0' or '1') (undocumented)
      */
-    nightSoundsOff?: string;
+    nightSoundsOff: string;
     /**
      * - Pause on power button press (undocumented)
      */
-    pausePowerButton?: boolean;
+    pausePowerButton: boolean;
     /**
      * - Pause on volume down (undocumented)
      */
-    pauseVolumeDown?: boolean;
+    pauseVolumeDown: boolean;
     /**
      * - Whether repeat all is enabled
      */
@@ -667,23 +955,23 @@ export type YotoDeviceConfig = {
     /**
      * - Show diagnostics (undocumented)
      */
-    showDiagnostics?: boolean;
+    showDiagnostics: boolean;
     /**
      * - Shutdown timeout in seconds
      */
     shutdownTimeout: string;
     /**
-     * - System volume level (undocumented)
+     * - System volume level (e.g., '100') (undocumented)
      */
-    systemVolume?: string;
+    systemVolume: string;
     /**
-     * - Timezone setting (undocumented)
+     * - Timezone setting (empty string if not set) (undocumented)
      */
-    timezone?: string;
+    timezone: string;
     /**
-     * - Volume level preset (e.g., 'safe')
+     * - Volume level preset (e.g., 'safe') (undocumented)
      */
-    volumeLevel?: string;
+    volumeLevel: string;
 };
 export type YotoDeviceShortcuts = {
     /**