jmri-client 4.1.0 → 4.1.1

package/docs/API.md

@@ -42,6 +42,12 @@ client.on('error', (error: Error) => { });
 // Power events
 client.on('power:changed', (state: PowerState) => { });
 
+// Turnout events
+client.on('turnout:changed', (name: string, state: TurnoutState) => { });
+
+// Light events
+client.on('light:changed', (name: string, state: LightState) => { });
+
 // Throttle events
 client.on('throttle:acquired', (throttleId: string) => { });
 client.on('throttle:updated', (throttleId: string, data: any) => { });
@@ -106,6 +112,38 @@ const entry = await client.getRosterEntryByAddress(3);
 const results = await client.searchRoster('steam');
 ```
 
+## Light Control
+
+```typescript
+// Get current light state
+const state: LightState = await client.getLight('IL1');
+
+// LightState enum values (from JMRI JSON protocol):
+// LightState.UNKNOWN = 0  (state cannot be determined)
+// LightState.ON = 2       (light is on)
+// LightState.OFF = 4      (light is off)
+
+// Set light state
+await client.setLight('IL1', LightState.ON);
+await client.turnOnLight('IL1');   // Convenience method
+await client.turnOffLight('IL1');  // Convenience method
+
+// List all lights
+const lights: LightData[] = await client.listLights();
+for (const light of lights) {
+  console.log(`${light.userName}: ${light.state === LightState.ON ? 'ON' : 'OFF'}`);
+}
+
+// Cached state (no network request)
+const cachedState = client.getLightState('IL1');
+const allCached = client.getCachedLights();
+
+// Listen for light changes
+client.on('light:changed', (name: string, state: LightState) => {
+  console.log(`Light ${name} changed to ${state === LightState.ON ? 'ON' : 'OFF'}`);
+});
+```
+
 ## Throttle Control
 
 ```typescript
@@ -165,12 +203,15 @@ const state = client.getConnectionState();
 ## Utility Functions
 
 ```typescript
-import { powerStateToString, isThrottleFunctionKey, isValidSpeed } from 'jmri-client';
+import { powerStateToString, lightStateToString, isThrottleFunctionKey, isValidSpeed } from 'jmri-client';
 
 // Convert PowerState enum to readable string
 const stateStr = powerStateToString(PowerState.ON);  // 'ON'
 const stateStr2 = powerStateToString(PowerState.UNKNOWN);  // 'UNKNOWN'
 
+// Convert LightState enum to readable string
+const lightStr = lightStateToString(LightState.ON);  // 'ON'
+
 // Validate throttle function key
 isThrottleFunctionKey('F0');  // true
 isThrottleFunctionKey('F99');  // false
@@ -189,7 +230,11 @@ import {
   JmriClient,
   JmriClientOptions,
   PowerState,
+  LightState,
+  LightData,
   RosterEntry,
+  TurnoutState,
+  TurnoutData,
   ThrottleState,
   ThrottleFunctionKey,
   ConnectionState

package/docs/EXAMPLES.md

@@ -113,6 +113,37 @@ client.on('connected', async () => {
 });
 ```
 
+## Light Control
+
+```typescript
+import { JmriClient, LightState } from 'jmri-client';
+
+const client = new JmriClient({ host: 'jmri.local' });
+
+client.on('connected', async () => {
+  // List all lights
+  const lights = await client.listLights();
+  console.log(`Found ${lights.length} lights`);
+
+  for (const light of lights) {
+    console.log(`  ${light.userName ?? light.name}: ${light.state === LightState.ON ? 'ON' : 'OFF'}`);
+  }
+
+  // Turn a light on
+  await client.turnOnLight('IL1');
+  console.log('Light IL1 turned ON');
+
+  // Turn it off again
+  await client.turnOffLight('IL1');
+  console.log('Light IL1 turned OFF');
+});
+
+// Monitor light changes in real-time
+client.on('light:changed', (name, state) => {
+  console.log(`Light ${name} is now ${state === LightState.ON ? 'ON' : 'OFF'}`);
+});
+```
+
 ## Roster Search
 
 ```typescript

package/docs/MOCK_MODE.md

@@ -72,6 +72,18 @@ Three sample locomotives:
 
 Each includes realistic function key mappings (F0-F4).
 
+### Lights
+Three sample lights:
+- **IL1** - Yard Light (OFF)
+- **IL2** - Platform Light (OFF)
+- **IL3** - Signal Lamp (ON)
+
+### Turnouts
+Three sample turnouts:
+- **LT1** - Main Diverge (CLOSED)
+- **LT2** - Yard Lead (CLOSED)
+- **LT3** - Siding Entry (THROWN)
+
 ### Throttle Responses
 Supports all throttle operations:
 - Acquire/release
@@ -152,6 +164,8 @@ const response = await mockManager.getMockResponse({
 The mock system maintains state for realistic behavior:
 
 - **Power state** - Remembers if power is ON or OFF
+- **Light states** - Tracks ON/OFF state per light
+- **Turnout states** - Tracks CLOSED/THROWN state per turnout
 - **Throttles** - Tracks acquired throttles and their states
 - **Speed/Direction** - Maintains current speed and direction per throttle
 - **Functions** - Tracks function key states (F0-F28)
@@ -196,6 +210,8 @@ Mock mode implements the full JMRI client API. All methods work identically:
 - ✅ `connect()` / `disconnect()`
 - ✅ `getPower()` / `powerOn()` / `powerOff()`
 - ✅ `getRoster()`
+- ✅ `getLight()` / `setLight()` / `turnOnLight()` / `turnOffLight()` / `listLights()`
+- ✅ `getTurnout()` / `setTurnout()` / `throwTurnout()` / `closeTurnout()` / `listTurnouts()`
 - ✅ `acquireThrottle()` / `releaseThrottle()`
 - ✅ `setThrottleSpeed()`
 - ✅ `setThrottleDirection()`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jmri-client",
-  "version": "4.1.0",
+  "version": "4.1.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",