jmri-client 3.2.1 → 3.3.1

package/docs/EXAMPLES.md

@@ -9,7 +9,11 @@ const client = new JmriClient({ host: 'jmri.local' });
 
 client.on('connected', async () => {
   const power = await client.getPower();
-  console.log('Current power:', power === PowerState.ON ? 'ON' : 'OFF');
+
+  // Handle all three power states
+  const powerStr = power === PowerState.ON ? 'ON' :
+                   power === PowerState.OFF ? 'OFF' : 'UNKNOWN';
+  console.log('Current power:', powerStr);
 
   await client.powerOn();
   console.log('Power turned ON');
@@ -69,9 +73,11 @@ client.on('reconnecting', (attempt, delay) => {
 });
 client.on('reconnected', () => console.log('✓ Reconnected!'));
 
-// Monitor power changes
+// Monitor power changes (including UNKNOWN state)
 client.on('power:changed', (state) => {
-  console.log('Power changed:', state === PowerState.ON ? 'ON' : 'OFF');
+  const stateStr = state === PowerState.ON ? 'ON' :
+                   state === PowerState.OFF ? 'OFF' : 'UNKNOWN';
+  console.log('Power changed:', stateStr);
 });
 
 // Monitor throttle updates
@@ -255,6 +261,8 @@ const client = new JmriClient({ host: 'jmri.local' });
 
 client.on('connected', async () => {
   const power = await client.getPower();
-  console.log('Power:', power === PowerState.ON ? 'ON' : 'OFF');
+  const powerStr = power === PowerState.ON ? 'ON' :
+                   power === PowerState.OFF ? 'OFF' : 'UNKNOWN';
+  console.log('Power:', powerStr);
 });
 ```

package/docs/MIGRATION.md

@@ -44,7 +44,7 @@ console.log(powerState);  // Direct value (PowerState enum)
 **Changes:**
 - Methods return data directly instead of axios response objects
 - No more `.data` property on responses
-- Power state is now a `PowerState` enum (ON=2, OFF=4)
+- Power state is now a `PowerState` enum (UNKNOWN=0, ON=2, OFF=4)
 
 ### 3. Power Control
 
@@ -221,7 +221,9 @@ client.on('connected', () => {
 });
 
 client.on('power:changed', (state) => {
-  console.log('Power changed:', state === PowerState.ON ? 'ON' : 'OFF');
+  const stateStr = state === PowerState.ON ? 'ON' :
+                   state === PowerState.OFF ? 'OFF' : 'UNKNOWN';
+  console.log('Power changed:', stateStr);
 });
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jmri-client",
-  "version": "3.2.1",
+  "version": "3.3.1",
   "description": "WebSocket client for JMRI with real-time updates and throttle control - works in both Node.js and browsers",
   "main": "./dist/cjs/index.js",
   "module": "./dist/esm/index.js",