yoto-nodejs-client 0.0.6 → 0.0.8

package/lib/yoto-device.d.ts

@@ -171,6 +171,10 @@ export const YotoPlaybackStateType: {};
  * MQTT disconnect event metadata (from MQTT disconnect packet)
  * @typedef {YotoMqttClientDisconnectMetadata} YotoMqttDisconnectMetadata
  */
+/**
+ * MQTT connect event metadata (from MQTT CONNACK)
+ * @typedef {IConnackPacket} YotoMqttConnectMetadata
+ */
 /**
  * MQTT close event metadata (from connection close)
  * @typedef {YotoMqttClientCloseMetadata} YotoMqttCloseMetadata
@@ -196,12 +200,17 @@ export const YotoPlaybackStateType: {};
  *   'playbackUpdate': [YotoPlaybackState, Set<keyof YotoPlaybackState>],
  *   'online': [YotoDeviceOnlineMetadata],
  *   'offline': [YotoDeviceOfflineMetadata],
- *   'mqttConnect': [],
+ *   'mqttConnect': [YotoMqttConnectMetadata],
  *   'mqttDisconnect': [YotoMqttDisconnectMetadata],
  *   'mqttClose': [YotoMqttCloseMetadata],
  *   'mqttReconnect': [],
  *   'mqttOffline': [],
  *   'mqttEnd': [],
+ *   'mqttStatus': [string, YotoStatusMessage],
+ *   'mqttEvents': [string, YotoEventsMessage],
+ *   'mqttStatusLegacy': [string, YotoStatusLegacyMessage],
+ *   'mqttResponse': [string, YotoResponseMessage],
+ *   'mqttUnknown': [string, unknown],
  *   'error': [Error]
  * }} YotoDeviceModelEventMap
  */
@@ -223,12 +232,17 @@ export const YotoPlaybackStateType: {};
  * - 'playbackUpdate' - Emitted when playback state changes, passes (playback, changedFields)
  * - 'online' - Emitted when device comes online, passes metadata with reason and optional upTime
  * - 'offline' - Emitted when device goes offline, passes metadata with reason and optional shutDownReason or timeSinceLastSeen
- * - 'mqttConnect' - Emitted when MQTT client connects
+ * - 'mqttConnect' - Emitted when MQTT client connects, passes CONNACK metadata
  * - 'mqttDisconnect' - Emitted when MQTT disconnect packet received, passes metadata with disconnect packet
  * - 'mqttClose' - Emitted when MQTT connection closes, passes metadata with close reason
  * - 'mqttReconnect' - Emitted when MQTT client is reconnecting
  * - 'mqttOffline' - Emitted when MQTT client goes offline
  * - 'mqttEnd' - Emitted when MQTT client end is called
+ * - 'mqttStatus' - Emitted with raw MQTT status messages, passes (topic, message)
+ * - 'mqttEvents' - Emitted with raw MQTT events messages, passes (topic, message)
+ * - 'mqttStatusLegacy' - Emitted with raw legacy MQTT status messages, passes (topic, message)
+ * - 'mqttResponse' - Emitted with raw MQTT response messages, passes (topic, message)
+ * - 'mqttUnknown' - Emitted with unknown MQTT messages, passes (topic, message)
  * - 'error' - Emitted when an error occurs, passes error
  *
  * @extends {EventEmitter<YotoDeviceModelEventMap>}
@@ -375,23 +389,10 @@ export class YotoDeviceModel extends EventEmitter<YotoDeviceModelEventMap> {
     reboot(): Promise<void>;
     /**
      * Start card playback over MQTT
-     * @param {Object} options - Card start options
-     * @param {string} options.uri - Card URI (e.g., "https://yoto.io/<cardID>")
-     * @param {string} [options.chapterKey] - Chapter to start from
-     * @param {string} [options.trackKey] - Track to start from
-     * @param {number} [options.secondsIn] - Playback start offset in seconds
-     * @param {number} [options.cutOff] - Playback stop offset in seconds
-     * @param {boolean} [options.anyButtonStop] - Whether button press stops playback
+     * @param {YotoCardStartOptions} options - Card start options
      * @returns {Promise<void>}
      */
-    startCard(options: {
-        uri: string;
-        chapterKey?: string | undefined;
-        trackKey?: string | undefined;
-        secondsIn?: number | undefined;
-        cutOff?: number | undefined;
-        anyButtonStop?: boolean | undefined;
-    }): Promise<void>;
+    startCard(options: YotoCardStartOptions): Promise<void>;
     /**
      * Stop card playback over MQTT
      * @returns {Promise<void>}
@@ -508,6 +509,35 @@ export type DayMode = "unknown" | "night" | "day";
  * Power source state
  */
 export type PowerSource = "battery" | "dock" | "usb-c" | "wireless";
+/**
+ * Card start options for Yoto playback.
+ */
+export type YotoCardStartOptions = {
+    /**
+     * - Card ID (used when uri is not provided)
+     */
+    cardId: string;
+    /**
+     * - Chapter to start from
+     */
+    chapterKey?: string;
+    /**
+     * - Track to start from
+     */
+    trackKey?: string;
+    /**
+     * - Playback start offset in seconds
+     */
+    secondsIn?: number;
+    /**
+     * - Playback stop offset in seconds
+     */
+    cutOff?: number;
+    /**
+     * - Whether button press stops playback
+     */
+    anyButtonStop?: boolean;
+};
 /**
  * Canonical device status - normalized format for both HTTP and MQTT sources
  *
@@ -946,6 +976,10 @@ export type YotoDeviceOfflineMetadata = {
  * MQTT disconnect event metadata (from MQTT disconnect packet)
  */
 export type YotoMqttDisconnectMetadata = YotoMqttClientDisconnectMetadata;
+/**
+ * MQTT connect event metadata (from MQTT CONNACK)
+ */
+export type YotoMqttConnectMetadata = IConnackPacket;
 /**
  * MQTT close event metadata (from connection close)
  */
@@ -994,12 +1028,17 @@ export type YotoDeviceModelEventMap = {
     "playbackUpdate": [YotoPlaybackState, Set<keyof YotoPlaybackState>];
     "online": [YotoDeviceOnlineMetadata];
     "offline": [YotoDeviceOfflineMetadata];
-    "mqttConnect": [];
+    "mqttConnect": [YotoMqttConnectMetadata];
     "mqttDisconnect": [YotoMqttDisconnectMetadata];
     "mqttClose": [YotoMqttCloseMetadata];
     "mqttReconnect": [];
     "mqttOffline": [];
     "mqttEnd": [];
+    "mqttStatus": [string, YotoStatusMessage];
+    "mqttEvents": [string, YotoEventsMessage];
+    "mqttStatusLegacy": [string, YotoStatusLegacyMessage];
+    "mqttResponse": [string, YotoResponseMessage];
+    "mqttUnknown": [string, unknown];
     "error": [Error];
 };
 import { EventEmitter } from 'events';
@@ -1012,5 +1051,10 @@ import type { YotoClient } from './api-client.js';
 import type { PlaybackStatus } from './mqtt/client.js';
 import type { YotoMqttOptions } from './mqtt/factory.js';
 import type { YotoMqttClientDisconnectMetadata } from './mqtt/client.js';
+import type { IConnackPacket } from 'mqtt';
 import type { YotoMqttClientCloseMetadata } from './mqtt/client.js';
+import type { YotoStatusMessage } from './mqtt/client.js';
+import type { YotoEventsMessage } from './mqtt/client.js';
+import type { YotoStatusLegacyMessage } from './mqtt/client.js';
+import type { YotoResponseMessage } from './mqtt/client.js';
 //# sourceMappingURL=yoto-device.d.ts.map

package/lib/yoto-device.d.ts.map

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

package/lib/yoto-device.js

@@ -7,10 +7,12 @@
  */
 
 /**
+ * @import { IConnackPacket } from 'mqtt'
  * @import { YotoClient } from './api-client.js'
  * @import { YotoDevice, YotoDeviceConfig, YotoDeviceShortcuts, YotoDeviceFullStatus, YotoDeviceStatusResponse, YotoDeviceCommand, YotoDeviceCommandResponse } from './api-endpoints/devices.js'
- * @import { YotoMqttClient, YotoMqttStatus, YotoEventsMessage, YotoLegacyStatus, YotoMqttClientDisconnectMetadata, YotoMqttClientCloseMetadata, PlaybackStatus } from './mqtt/client.js'
+ * @import { YotoMqttClient, YotoMqttStatus, YotoEventsMessage, YotoLegacyStatus, YotoStatusMessage, YotoStatusLegacyMessage, YotoResponseMessage, YotoMqttClientDisconnectMetadata, YotoMqttClientCloseMetadata, PlaybackStatus } from './mqtt/client.js'
  * @import { YotoMqttOptions } from './mqtt/factory.js'
+ * @import { YotoCardStartCommand } from './mqtt/commands.js'
  */
 
 import { EventEmitter } from 'events'
@@ -80,6 +82,17 @@ function convertPowerSource (numericSource) {
  * @typedef {'battery' | 'dock' | 'usb-c' | 'wireless'} PowerSource
  */
 
+/**
+ * Card start options for Yoto playback.
+ * @typedef {Object} YotoCardStartOptions
+ * @property {string} cardId - Card ID (used when uri is not provided)
+ * @property {string} [chapterKey] - Chapter to start from
+ * @property {string} [trackKey] - Track to start from
+ * @property {number} [secondsIn] - Playback start offset in seconds
+ * @property {number} [cutOff] - Playback stop offset in seconds
+ * @property {boolean} [anyButtonStop] - Whether button press stops playback
+ */
+
 /**
  * Normalize "0"/"1" booleans from config to true/false.
  * @param {string | boolean} value
@@ -459,6 +472,11 @@ export const YotoPlaybackStateType = {}
  * @typedef {YotoMqttClientDisconnectMetadata} YotoMqttDisconnectMetadata
  */
 
+/**
+ * MQTT connect event metadata (from MQTT CONNACK)
+ * @typedef {IConnackPacket} YotoMqttConnectMetadata
+ */
+
 /**
  * MQTT close event metadata (from connection close)
  * @typedef {YotoMqttClientCloseMetadata} YotoMqttCloseMetadata
@@ -486,12 +504,17 @@ export const YotoPlaybackStateType = {}
  *   'playbackUpdate': [YotoPlaybackState, Set<keyof YotoPlaybackState>],
  *   'online': [YotoDeviceOnlineMetadata],
  *   'offline': [YotoDeviceOfflineMetadata],
- *   'mqttConnect': [],
+ *   'mqttConnect': [YotoMqttConnectMetadata],
  *   'mqttDisconnect': [YotoMqttDisconnectMetadata],
  *   'mqttClose': [YotoMqttCloseMetadata],
  *   'mqttReconnect': [],
  *   'mqttOffline': [],
  *   'mqttEnd': [],
+ *   'mqttStatus': [string, YotoStatusMessage],
+ *   'mqttEvents': [string, YotoEventsMessage],
+ *   'mqttStatusLegacy': [string, YotoStatusLegacyMessage],
+ *   'mqttResponse': [string, YotoResponseMessage],
+ *   'mqttUnknown': [string, unknown],
  *   'error': [Error]
  * }} YotoDeviceModelEventMap
  */
@@ -518,12 +541,17 @@ export const YotoPlaybackStateType = {}
  * - 'playbackUpdate' - Emitted when playback state changes, passes (playback, changedFields)
  * - 'online' - Emitted when device comes online, passes metadata with reason and optional upTime
  * - 'offline' - Emitted when device goes offline, passes metadata with reason and optional shutDownReason or timeSinceLastSeen
- * - 'mqttConnect' - Emitted when MQTT client connects
+ * - 'mqttConnect' - Emitted when MQTT client connects, passes CONNACK metadata
  * - 'mqttDisconnect' - Emitted when MQTT disconnect packet received, passes metadata with disconnect packet
  * - 'mqttClose' - Emitted when MQTT connection closes, passes metadata with close reason
  * - 'mqttReconnect' - Emitted when MQTT client is reconnecting
  * - 'mqttOffline' - Emitted when MQTT client goes offline
  * - 'mqttEnd' - Emitted when MQTT client end is called
+ * - 'mqttStatus' - Emitted with raw MQTT status messages, passes (topic, message)
+ * - 'mqttEvents' - Emitted with raw MQTT events messages, passes (topic, message)
+ * - 'mqttStatusLegacy' - Emitted with raw legacy MQTT status messages, passes (topic, message)
+ * - 'mqttResponse' - Emitted with raw MQTT response messages, passes (topic, message)
+ * - 'mqttUnknown' - Emitted with unknown MQTT messages, passes (topic, message)
  * - 'error' - Emitted when an error occurs, passes error
  *
  * @extends {EventEmitter<YotoDeviceModelEventMap>}
@@ -925,17 +953,26 @@ export class YotoDeviceModel extends EventEmitter {
 
   /**
    * Start card playback over MQTT
-   * @param {Object} options - Card start options
-   * @param {string} options.uri - Card URI (e.g., "https://yoto.io/<cardID>")
-   * @param {string} [options.chapterKey] - Chapter to start from
-   * @param {string} [options.trackKey] - Track to start from
-   * @param {number} [options.secondsIn] - Playback start offset in seconds
-   * @param {number} [options.cutOff] - Playback stop offset in seconds
-   * @param {boolean} [options.anyButtonStop] - Whether button press stops playback
+   * @param {YotoCardStartOptions} options - Card start options
    * @returns {Promise<void>}
    */
   async startCard (options) {
-    return await this.#mqttClient?.startCard(options)
+    const uri = `https://yoto.io/${options.cardId}`
+
+    if (!uri) {
+      throw new Error('Card URI or cardId is required')
+    }
+
+    /** @type {YotoCardStartCommand} */
+    const payload = { uri }
+
+    if (typeof options.chapterKey === 'string') payload.chapterKey = options.chapterKey
+    if (typeof options.trackKey === 'string') payload.trackKey = options.trackKey
+    if (typeof options.secondsIn === 'number') payload.secondsIn = options.secondsIn
+    if (typeof options.cutOff === 'number') payload.cutOff = options.cutOff
+    if (typeof options.anyButtonStop === 'boolean') payload.anyButtonStop = options.anyButtonStop
+
+    return await this.#mqttClient?.startCard(payload)
   }
 
   /**
@@ -1144,8 +1181,8 @@ export class YotoDeviceModel extends EventEmitter {
     if (!this.#mqttClient) return
 
     // Connection events
-    this.#mqttClient.on('connect', () => {
-      this.emit('mqttConnect')
+    this.#mqttClient.on('connect', (metadata) => {
+      this.emit('mqttConnect', metadata)
 
       // Request status and events after settling period
       this.#scheduleMqttRequests()
@@ -1186,8 +1223,9 @@ export class YotoDeviceModel extends EventEmitter {
     })
 
     // Status updates - PRIMARY source for status after initialization
-    this.#mqttClient.on('status', (_topic, message) => {
+    this.#mqttClient.on('status', (topic, message) => {
       this.#recordDeviceActivity()
+      this.emit('mqttStatus', topic, message)
       this.#updateStatusFromDocumentedMqtt(message.status)
     })
 
@@ -1195,20 +1233,25 @@ export class YotoDeviceModel extends EventEmitter {
     // This does NOT respond to requestStatus() - only emits on real-time events or 5-minute periodic updates
     // NOTE: Don't call #recordDeviceActivity() here - #handleLegacyStatus handles online/offline transitions
     // based on actual power state (shutdown/startup) which is more reliable than just "activity"
-    this.#mqttClient.on('status-legacy', (_topic, message) => {
+    this.#mqttClient.on('status-legacy', (topic, message) => {
+      this.emit('mqttStatusLegacy', topic, message)
       this.#handleLegacyStatus(message.status)
     })
 
     // Events updates (playback, volume, etc.)
-    this.#mqttClient.on('events', (_topic, message) => {
+    this.#mqttClient.on('events', (topic, message) => {
       this.#recordDeviceActivity()
+      this.emit('mqttEvents', topic, message)
       this.#handleEventMessage(message)
     })
 
     // Response messages (for debugging/logging)
-    this.#mqttClient.on('response', (_topic, _message) => {
-      // Could emit these for command confirmation
-      // For now just log internally
+    this.#mqttClient.on('response', (topic, message) => {
+      this.emit('mqttResponse', topic, message)
+    })
+
+    this.#mqttClient.on('unknown', (topic, message) => {
+      this.emit('mqttUnknown', topic, message)
     })
   }
 

package/lib/yoto-device.test.js

@@ -1,15 +1,18 @@
-/** @import { YotoDeviceModelConfig, YotoPlaybackState } from './yoto-device.js' */
 /** @import { YotoDevice } from './api-endpoints/devices.js' */
 
 import test from 'node:test'
 import assert from 'node:assert/strict'
-import { once } from 'node:events'
-import { setTimeout as sleep } from 'node:timers/promises'
 import { join } from 'node:path'
 import { YotoClient } from './api-client.js'
 import { YotoDeviceModel } from './yoto-device.js'
 import { loadTestTokens } from './api-endpoints/endpoint-test-helpers.js'
 import { saveTokensToEnv } from '../bin/lib/token-helpers.js'
+import {
+  assertConfigShape,
+  assertPlaybackShape,
+  toLower,
+  waitForModelReady
+} from './test-helpers/device-model-test-helpers.js'
 
 const envPath = join(import.meta.dirname, '..', '.env')
 
@@ -41,109 +44,6 @@ function createTestClient () {
   })
 }
 
-/**
- * @param {Promise<unknown>} promise
- * @param {number} timeoutMs
- * @param {string} label
- * @returns {Promise<unknown>}
- */
-function withTimeout (promise, timeoutMs, label) {
-  return Promise.race([
-    promise,
-    sleep(timeoutMs).then(() => {
-      throw new Error(`${label} timed out after ${timeoutMs}ms`)
-    })
-  ])
-}
-
-/**
- * @param {YotoDeviceModel} model
- * @returns {Promise<void>}
- */
-async function waitForModelReady (model) {
-  const started = withTimeout(once(model, 'started'), 15000, 'started')
-  const statusUpdated = withTimeout(once(model, 'statusUpdate'), 15000, 'statusUpdate')
-  const configUpdated = withTimeout(once(model, 'configUpdate'), 15000, 'configUpdate')
-
-  await model.start()
-  await Promise.all([started, statusUpdated, configUpdated])
-  await sleep(1500)
-}
-
-/**
- * @param {YotoDeviceModelConfig} config
- */
-function assertConfigShape (config) {
-  assert.ok(Array.isArray(config.alarms), 'alarms should be an array')
-  assert.equal(typeof config.ambientColour, 'string', 'ambientColour should be string')
-  assert.equal(typeof config.bluetoothEnabled, 'boolean', 'bluetoothEnabled should be boolean')
-  assert.equal(typeof config.btHeadphonesEnabled, 'boolean', 'btHeadphonesEnabled should be boolean')
-  assert.equal(typeof config.clockFace, 'string', 'clockFace should be string')
-  assert.equal(typeof config.dayDisplayBrightnessAuto, 'boolean', 'dayDisplayBrightnessAuto should be boolean')
-  if (config.dayDisplayBrightnessAuto) {
-    assert.equal(config.dayDisplayBrightness, null, 'dayDisplayBrightness should be null when auto')
-  } else {
-    assert.equal(typeof config.dayDisplayBrightness, 'number', 'dayDisplayBrightness should be number when not auto')
-  }
-  assert.equal(typeof config.dayTime, 'string', 'dayTime should be string')
-  assert.equal(typeof config.dayYotoDaily, 'string', 'dayYotoDaily should be string')
-  assert.equal(typeof config.dayYotoRadio, 'string', 'dayYotoRadio should be string')
-  assert.equal(typeof config.daySoundsOff, 'boolean', 'daySoundsOff should be boolean')
-  assert.equal(typeof config.displayDimBrightness, 'number', 'displayDimBrightness should be number')
-  assert.equal(typeof config.displayDimTimeout, 'number', 'displayDimTimeout should be number')
-  assert.equal(typeof config.headphonesVolumeLimited, 'boolean', 'headphonesVolumeLimited should be boolean')
-  assert.ok(config.hourFormat === 12 || config.hourFormat === 24, 'hourFormat should be 12 or 24')
-  assert.equal(typeof config.locale, 'string', 'locale should be string')
-  assert.equal(typeof config.logLevel, 'string', 'logLevel should be string')
-  assert.equal(typeof config.maxVolumeLimit, 'number', 'maxVolumeLimit should be number')
-  assert.equal(typeof config.nightAmbientColour, 'string', 'nightAmbientColour should be string')
-  assert.equal(typeof config.nightDisplayBrightnessAuto, 'boolean', 'nightDisplayBrightnessAuto should be boolean')
-  if (config.nightDisplayBrightnessAuto) {
-    assert.equal(config.nightDisplayBrightness, null, 'nightDisplayBrightness should be null when auto')
-  } else {
-    assert.equal(typeof config.nightDisplayBrightness, 'number', 'nightDisplayBrightness should be number when not auto')
-  }
-  assert.equal(typeof config.nightMaxVolumeLimit, 'number', 'nightMaxVolumeLimit should be number')
-  assert.equal(typeof config.nightTime, 'string', 'nightTime should be string')
-  assert.equal(typeof config.nightYotoDaily, 'string', 'nightYotoDaily should be string')
-  assert.equal(typeof config.nightYotoRadioEnabled, 'boolean', 'nightYotoRadioEnabled should be boolean')
-  if (config.nightYotoRadioEnabled) {
-    assert.equal(typeof config.nightYotoRadio, 'string', 'nightYotoRadio should be string when enabled')
-  } else {
-    assert.equal(config.nightYotoRadio, null, 'nightYotoRadio should be null when disabled')
-  }
-  assert.equal(typeof config.nightSoundsOff, 'boolean', 'nightSoundsOff should be boolean')
-  assert.equal(typeof config.pausePowerButton, 'boolean', 'pausePowerButton should be boolean')
-  assert.equal(typeof config.pauseVolumeDown, 'boolean', 'pauseVolumeDown should be boolean')
-  assert.equal(typeof config.repeatAll, 'boolean', 'repeatAll should be boolean')
-  assert.equal(typeof config.showDiagnostics, 'boolean', 'showDiagnostics should be boolean')
-  assert.equal(typeof config.shutdownTimeout, 'number', 'shutdownTimeout should be number')
-  assert.equal(typeof config.systemVolume, 'number', 'systemVolume should be number')
-  assert.equal(typeof config.timezone, 'string', 'timezone should be string')
-  assert.equal(typeof config.volumeLevel, 'string', 'volumeLevel should be string')
-}
-
-/**
- * @param {YotoPlaybackState} playback
- */
-function assertPlaybackShape (playback) {
-  assert.ok(playback, 'playback should exist')
-  assert.equal(typeof playback.updatedAt, 'string', 'playback.updatedAt should be string')
-
-  assert.ok(playback.cardId === null || typeof playback.cardId === 'string', 'playback.cardId should be string or null')
-  assert.ok(playback.source === null || typeof playback.source === 'string', 'playback.source should be string or null')
-  assert.ok(playback.playbackStatus === null || typeof playback.playbackStatus === 'string', 'playback.playbackStatus should be string or null')
-  assert.ok(playback.trackTitle === null || typeof playback.trackTitle === 'string', 'playback.trackTitle should be string or null')
-  assert.ok(playback.trackKey === null || typeof playback.trackKey === 'string', 'playback.trackKey should be string or null')
-  assert.ok(playback.chapterTitle === null || typeof playback.chapterTitle === 'string', 'playback.chapterTitle should be string or null')
-  assert.ok(playback.chapterKey === null || typeof playback.chapterKey === 'string', 'playback.chapterKey should be string or null')
-  assert.ok(playback.position === null || typeof playback.position === 'number', 'playback.position should be number or null')
-  assert.ok(playback.trackLength === null || typeof playback.trackLength === 'number', 'playback.trackLength should be number or null')
-  assert.ok(playback.streaming === null || typeof playback.streaming === 'boolean', 'playback.streaming should be boolean or null')
-  assert.ok(playback.sleepTimerActive === null || typeof playback.sleepTimerActive === 'boolean', 'playback.sleepTimerActive should be boolean or null')
-  assert.ok(playback.sleepTimerSeconds === null || typeof playback.sleepTimerSeconds === 'number', 'playback.sleepTimerSeconds should be number or null')
-}
-
 /**
  * @param {YotoClient} client
  * @param {YotoDevice} device
@@ -169,11 +69,6 @@ test('YotoDeviceModel - online devices', async (t) => {
   const client = createTestClient()
   const response = await client.getDevices()
 
-  /**
-   * @param {string | undefined} value
-   * @returns {string}
-   */
-  const toLower = (value) => typeof value === 'string' ? value.toLowerCase() : ''
   const onlineMini = response.devices.find(device =>
     device.online && (toLower(device.deviceFamily) === 'mini' || toLower(device.deviceType).includes('mini'))
   )

package/package.json

@@ -1,7 +1,7 @@
 {
   "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.6",
+  "version": "0.0.8",
   "author": "Bret Comnes <bcomnes@gmail.com> (https://bret.io)",
   "bugs": {
     "url": "https://github.com/bcomnes/yoto-nodejs-client/issues"
@@ -69,17 +69,9 @@
     "type": "git",
     "url": "https://github.com/bcomnes/yoto-nodejs-client.git"
   },
-  "funding": {
-    "type": "individual",
-    "url": "https://github.com/sponsors/bcomnes"
-  },
-  "c8": {
-    "reporter": [
-      "lcov",
-      "text"
-    ]
-  },
   "scripts": {
+    "prepublishOnly": "npm run build && git push --follow-tags && gh-release -y",
+    "postpublish": "npm run clean",
     "test": "run-s test:*",
     "test:lint": "eslint",
     "test:tsc": "tsc",
@@ -93,5 +85,15 @@
     "clean:declarations-top": "rm -rf $(find . -maxdepth 1 -type f -name '*.d.ts*' -o -name '*.d.cts*' -o -name '*.d.mts*')",
     "clean:declarations-lib": "rm -rf $(find lib -type f \\( -name '*.d.ts*' -o -name '*.d.cts*' -o -name '*.d.mts*' \\) ! -name '*-types.d.ts')",
     "clean:declarations-bin": "rm -rf $(find bin -type f \\( -name '*.d.ts*' -o -name '*.d.cts*' -o -name '*.d.mts*' \\) ! -name '*-types.d.ts')"
+  },
+  "funding": {
+    "type": "individual",
+    "url": "https://github.com/sponsors/bcomnes"
+  },
+  "c8": {
+    "reporter": [
+      "lcov",
+      "text"
+    ]
   }
-}
+}