jmri-client 5.0.0 → 5.1.0

package/dist/browser/jmri-client.js

@@ -723,8 +723,8 @@ var mockData = {
             { "name": "F4", "label": "Dynamic Brake", "lockable": true, "icon": null, "selectedIcon": null },
             { "name": "F5", "label": null, "lockable": false, "icon": null, "selectedIcon": null }
           ],
-          "attributes": [],
-          "rosterGroups": []
+          "attributes": [{ "name": "RosterGroup:diesels", "value": "yes" }],
+          "rosterGroups": ["diesels"]
         },
         "id": 1
       },
@@ -754,8 +754,8 @@ var mockData = {
             { "name": "F3", "label": "Steam", "lockable": true, "icon": null, "selectedIcon": null },
             { "name": "F4", "label": null, "lockable": false, "icon": null, "selectedIcon": null }
           ],
-          "attributes": [],
-          "rosterGroups": []
+          "attributes": [{ "name": "RosterGroup:steam", "value": "yes" }],
+          "rosterGroups": ["steam"]
         },
         "id": 2
       },
@@ -786,13 +786,19 @@ var mockData = {
             { "name": "F4", "label": null, "lockable": false, "icon": null, "selectedIcon": null },
             { "name": "F5", "label": "Mars Light", "lockable": true, "icon": null, "selectedIcon": null }
           ],
-          "attributes": [],
-          "rosterGroups": []
+          "attributes": [{ "name": "RosterGroup:diesels", "value": "yes" }],
+          "rosterGroups": ["diesels"]
         },
         "id": 3
       }
     ]
   },
+  "rosterGroup": {
+    "list": [
+      { "type": "rosterGroup", "data": { "name": "diesels", "length": 2 } },
+      { "type": "rosterGroup", "data": { "name": "steam", "length": 1 } }
+    ]
+  },
   "throttle": {
     "acquire": {
       "success": {
@@ -891,6 +897,7 @@ var mockData = {
 // src/mocks/mock-response-manager.ts
 var MockResponseManager = class {
   constructor(options = {}) {
+    this.powerStateByPrefix = /* @__PURE__ */ new Map();
     this.throttles = /* @__PURE__ */ new Map();
     this.lights = /* @__PURE__ */ new Map([
       ["IL1", 4 /* OFF */],
@@ -919,6 +926,8 @@ var MockResponseManager = class {
         return this.getPowerResponse(message);
       case "roster":
         return this.getRosterResponse(message);
+      case "rosterGroup":
+        return this.getRosterGroupResponse();
       case "throttle":
         return this.getThrottleResponse(message);
       case "light":
@@ -940,34 +949,48 @@ var MockResponseManager = class {
     return JSON.parse(JSON.stringify(mockData.hello));
   }
   /**
-   * Get power response
+   * Get power response, with optional per-prefix state tracking
    */
   getPowerResponse(message) {
-    if (message.data?.state !== void 0) {
+    const prefix = message.data?.prefix;
+    if (message.method === "post" && message.data?.state !== void 0) {
+      if (prefix !== void 0) {
+        this.powerStateByPrefix.set(prefix, message.data.state);
+        return { type: "power", data: { state: message.data.state, prefix } };
+      }
       this.powerState = message.data.state;
-      return {
-        type: "power",
-        data: { state: this.powerState }
-      };
+      return { type: "power", data: { state: this.powerState } };
     }
-    return {
-      type: "power",
-      data: { state: this.powerState }
-    };
+    if (prefix !== void 0) {
+      const state = this.powerStateByPrefix.get(prefix) ?? 0 /* UNKNOWN */;
+      return { type: "power", data: { state, prefix } };
+    }
+    return { type: "power", data: { state: this.powerState } };
   }
   /**
-   * Get roster response
+   * Get roster response, optionally filtered by group
    */
   getRosterResponse(message) {
     if (message.type === "roster" && message.method === "list") {
-      return {
-        type: "roster",
-        data: JSON.parse(JSON.stringify(mockData.roster.list))
-      };
+      const all = JSON.parse(JSON.stringify(mockData.roster.list));
+      const group = message.params?.group;
+      if (group) {
+        return {
+          type: "roster",
+          data: all.filter((e) => e.data.rosterGroups?.includes(group))
+        };
+      }
+      return { type: "roster", data: all };
     }
+    return { type: "roster", data: [] };
+  }
+  /**
+   * Get roster group response
+   */
+  getRosterGroupResponse() {
     return {
-      type: "roster",
-      data: []
+      type: "rosterGroup",
+      data: JSON.parse(JSON.stringify(mockData.rosterGroup.list))
     };
   }
   /**
@@ -986,13 +1009,11 @@ var MockResponseManager = class {
         F1: false,
         F2: false,
         F3: false,
-        F4: false
+        F4: false,
+        ...data.prefix !== void 0 && { prefix: data.prefix }
       };
       this.throttles.set(throttleId, throttleState);
-      return {
-        type: "throttle",
-        data: { ...throttleState }
-      };
+      return { type: "throttle", data: { ...throttleState } };
     }
     if (data.release !== void 0 && data.throttle) {
       this.throttles.delete(data.throttle);
@@ -1125,6 +1146,7 @@ var MockResponseManager = class {
    */
   reset() {
     this.powerState = 4 /* OFF */;
+    this.powerStateByPrefix.clear();
     this.throttles.clear();
     this.lights = /* @__PURE__ */ new Map([
       ["IL1", 4 /* OFF */],
@@ -1608,6 +1630,32 @@ var RosterManager = class {
     }
     return results;
   }
+  /**
+   * Get all roster groups
+   */
+  async getRosterGroups() {
+    const message = {
+      type: "rosterGroup",
+      method: "list"
+    };
+    const response = await this.client.request(message);
+    if (!response.data) return [];
+    return response.data.map((wrapper) => wrapper.data);
+  }
+  /**
+   * Get roster entries belonging to a specific group
+   */
+  async getRosterEntriesByGroup(group) {
+    const message = {
+      type: "roster",
+      method: "list",
+      params: { group }
+    };
+    const response = await this.client.request(message);
+    if (!response.data) return [];
+    const entries = response.data;
+    return entries.filter((e) => e.type === "rosterEntry");
+  }
   /**
    * Get cached roster (no network request)
    */
@@ -2315,6 +2363,18 @@ var JmriClient = class extends import_index.default {
   async searchRoster(query) {
     return this.rosterManager.searchRoster(query);
   }
+  /**
+   * Get all roster groups
+   */
+  async getRosterGroups() {
+    return this.rosterManager.getRosterGroups();
+  }
+  /**
+   * Get roster entries belonging to a specific group
+   */
+  async getRosterEntriesByGroup(group) {
+    return this.rosterManager.getRosterEntriesByGroup(group);
+  }
   // ============================================================================
   // Turnout Control
   // ============================================================================

package/dist/cjs/index.js

@@ -581,8 +581,8 @@ var mockData = {
             { "name": "F4", "label": "Dynamic Brake", "lockable": true, "icon": null, "selectedIcon": null },
             { "name": "F5", "label": null, "lockable": false, "icon": null, "selectedIcon": null }
           ],
-          "attributes": [],
-          "rosterGroups": []
+          "attributes": [{ "name": "RosterGroup:diesels", "value": "yes" }],
+          "rosterGroups": ["diesels"]
         },
         "id": 1
       },
@@ -612,8 +612,8 @@ var mockData = {
             { "name": "F3", "label": "Steam", "lockable": true, "icon": null, "selectedIcon": null },
             { "name": "F4", "label": null, "lockable": false, "icon": null, "selectedIcon": null }
           ],
-          "attributes": [],
-          "rosterGroups": []
+          "attributes": [{ "name": "RosterGroup:steam", "value": "yes" }],
+          "rosterGroups": ["steam"]
         },
         "id": 2
       },
@@ -644,13 +644,19 @@ var mockData = {
             { "name": "F4", "label": null, "lockable": false, "icon": null, "selectedIcon": null },
             { "name": "F5", "label": "Mars Light", "lockable": true, "icon": null, "selectedIcon": null }
           ],
-          "attributes": [],
-          "rosterGroups": []
+          "attributes": [{ "name": "RosterGroup:diesels", "value": "yes" }],
+          "rosterGroups": ["diesels"]
         },
         "id": 3
       }
     ]
   },
+  "rosterGroup": {
+    "list": [
+      { "type": "rosterGroup", "data": { "name": "diesels", "length": 2 } },
+      { "type": "rosterGroup", "data": { "name": "steam", "length": 1 } }
+    ]
+  },
   "throttle": {
     "acquire": {
       "success": {
@@ -749,6 +755,7 @@ var mockData = {
 // src/mocks/mock-response-manager.ts
 var MockResponseManager = class {
   constructor(options = {}) {
+    this.powerStateByPrefix = /* @__PURE__ */ new Map();
     this.throttles = /* @__PURE__ */ new Map();
     this.lights = /* @__PURE__ */ new Map([
       ["IL1", 4 /* OFF */],
@@ -777,6 +784,8 @@ var MockResponseManager = class {
         return this.getPowerResponse(message);
       case "roster":
         return this.getRosterResponse(message);
+      case "rosterGroup":
+        return this.getRosterGroupResponse();
       case "throttle":
         return this.getThrottleResponse(message);
       case "light":
@@ -798,34 +807,48 @@ var MockResponseManager = class {
     return JSON.parse(JSON.stringify(mockData.hello));
   }
   /**
-   * Get power response
+   * Get power response, with optional per-prefix state tracking
    */
   getPowerResponse(message) {
-    if (message.data?.state !== void 0) {
+    const prefix = message.data?.prefix;
+    if (message.method === "post" && message.data?.state !== void 0) {
+      if (prefix !== void 0) {
+        this.powerStateByPrefix.set(prefix, message.data.state);
+        return { type: "power", data: { state: message.data.state, prefix } };
+      }
       this.powerState = message.data.state;
-      return {
-        type: "power",
-        data: { state: this.powerState }
-      };
+      return { type: "power", data: { state: this.powerState } };
     }
-    return {
-      type: "power",
-      data: { state: this.powerState }
-    };
+    if (prefix !== void 0) {
+      const state = this.powerStateByPrefix.get(prefix) ?? 0 /* UNKNOWN */;
+      return { type: "power", data: { state, prefix } };
+    }
+    return { type: "power", data: { state: this.powerState } };
   }
   /**
-   * Get roster response
+   * Get roster response, optionally filtered by group
    */
   getRosterResponse(message) {
     if (message.type === "roster" && message.method === "list") {
-      return {
-        type: "roster",
-        data: JSON.parse(JSON.stringify(mockData.roster.list))
-      };
+      const all = JSON.parse(JSON.stringify(mockData.roster.list));
+      const group = message.params?.group;
+      if (group) {
+        return {
+          type: "roster",
+          data: all.filter((e) => e.data.rosterGroups?.includes(group))
+        };
+      }
+      return { type: "roster", data: all };
     }
+    return { type: "roster", data: [] };
+  }
+  /**
+   * Get roster group response
+   */
+  getRosterGroupResponse() {
     return {
-      type: "roster",
-      data: []
+      type: "rosterGroup",
+      data: JSON.parse(JSON.stringify(mockData.rosterGroup.list))
     };
   }
   /**
@@ -844,13 +867,11 @@ var MockResponseManager = class {
         F1: false,
         F2: false,
         F3: false,
-        F4: false
+        F4: false,
+        ...data.prefix !== void 0 && { prefix: data.prefix }
       };
       this.throttles.set(throttleId, throttleState);
-      return {
-        type: "throttle",
-        data: { ...throttleState }
-      };
+      return { type: "throttle", data: { ...throttleState } };
     }
     if (data.release !== void 0 && data.throttle) {
       this.throttles.delete(data.throttle);
@@ -983,6 +1004,7 @@ var MockResponseManager = class {
    */
   reset() {
     this.powerState = 4 /* OFF */;
+    this.powerStateByPrefix.clear();
     this.throttles.clear();
     this.lights = /* @__PURE__ */ new Map([
       ["IL1", 4 /* OFF */],
@@ -1467,6 +1489,32 @@ var RosterManager = class {
     }
     return results;
   }
+  /**
+   * Get all roster groups
+   */
+  async getRosterGroups() {
+    const message = {
+      type: "rosterGroup",
+      method: "list"
+    };
+    const response = await this.client.request(message);
+    if (!response.data) return [];
+    return response.data.map((wrapper) => wrapper.data);
+  }
+  /**
+   * Get roster entries belonging to a specific group
+   */
+  async getRosterEntriesByGroup(group) {
+    const message = {
+      type: "roster",
+      method: "list",
+      params: { group }
+    };
+    const response = await this.client.request(message);
+    if (!response.data) return [];
+    const entries = response.data;
+    return entries.filter((e) => e.type === "rosterEntry");
+  }
   /**
    * Get cached roster (no network request)
    */
@@ -2179,6 +2227,18 @@ var JmriClient = class extends import_eventemitter310.EventEmitter {
   async searchRoster(query) {
     return this.rosterManager.searchRoster(query);
   }
+  /**
+   * Get all roster groups
+   */
+  async getRosterGroups() {
+    return this.rosterManager.getRosterGroups();
+  }
+  /**
+   * Get roster entries belonging to a specific group
+   */
+  async getRosterEntriesByGroup(group) {
+    return this.rosterManager.getRosterEntriesByGroup(group);
+  }
   // ============================================================================
   // Turnout Control
   // ============================================================================

package/dist/esm/index.js

@@ -532,8 +532,8 @@ var mockData = {
             { "name": "F4", "label": "Dynamic Brake", "lockable": true, "icon": null, "selectedIcon": null },
             { "name": "F5", "label": null, "lockable": false, "icon": null, "selectedIcon": null }
           ],
-          "attributes": [],
-          "rosterGroups": []
+          "attributes": [{ "name": "RosterGroup:diesels", "value": "yes" }],
+          "rosterGroups": ["diesels"]
         },
         "id": 1
       },
@@ -563,8 +563,8 @@ var mockData = {
             { "name": "F3", "label": "Steam", "lockable": true, "icon": null, "selectedIcon": null },
             { "name": "F4", "label": null, "lockable": false, "icon": null, "selectedIcon": null }
           ],
-          "attributes": [],
-          "rosterGroups": []
+          "attributes": [{ "name": "RosterGroup:steam", "value": "yes" }],
+          "rosterGroups": ["steam"]
         },
         "id": 2
       },
@@ -595,13 +595,19 @@ var mockData = {
             { "name": "F4", "label": null, "lockable": false, "icon": null, "selectedIcon": null },
             { "name": "F5", "label": "Mars Light", "lockable": true, "icon": null, "selectedIcon": null }
           ],
-          "attributes": [],
-          "rosterGroups": []
+          "attributes": [{ "name": "RosterGroup:diesels", "value": "yes" }],
+          "rosterGroups": ["diesels"]
         },
         "id": 3
       }
     ]
   },
+  "rosterGroup": {
+    "list": [
+      { "type": "rosterGroup", "data": { "name": "diesels", "length": 2 } },
+      { "type": "rosterGroup", "data": { "name": "steam", "length": 1 } }
+    ]
+  },
   "throttle": {
     "acquire": {
       "success": {
@@ -700,6 +706,7 @@ var mockData = {
 // src/mocks/mock-response-manager.ts
 var MockResponseManager = class {
   constructor(options = {}) {
+    this.powerStateByPrefix = /* @__PURE__ */ new Map();
     this.throttles = /* @__PURE__ */ new Map();
     this.lights = /* @__PURE__ */ new Map([
       ["IL1", 4 /* OFF */],
@@ -728,6 +735,8 @@ var MockResponseManager = class {
         return this.getPowerResponse(message);
       case "roster":
         return this.getRosterResponse(message);
+      case "rosterGroup":
+        return this.getRosterGroupResponse();
       case "throttle":
         return this.getThrottleResponse(message);
       case "light":
@@ -749,34 +758,48 @@ var MockResponseManager = class {
     return JSON.parse(JSON.stringify(mockData.hello));
   }
   /**
-   * Get power response
+   * Get power response, with optional per-prefix state tracking
    */
   getPowerResponse(message) {
-    if (message.data?.state !== void 0) {
+    const prefix = message.data?.prefix;
+    if (message.method === "post" && message.data?.state !== void 0) {
+      if (prefix !== void 0) {
+        this.powerStateByPrefix.set(prefix, message.data.state);
+        return { type: "power", data: { state: message.data.state, prefix } };
+      }
       this.powerState = message.data.state;
-      return {
-        type: "power",
-        data: { state: this.powerState }
-      };
+      return { type: "power", data: { state: this.powerState } };
     }
-    return {
-      type: "power",
-      data: { state: this.powerState }
-    };
+    if (prefix !== void 0) {
+      const state = this.powerStateByPrefix.get(prefix) ?? 0 /* UNKNOWN */;
+      return { type: "power", data: { state, prefix } };
+    }
+    return { type: "power", data: { state: this.powerState } };
   }
   /**
-   * Get roster response
+   * Get roster response, optionally filtered by group
    */
   getRosterResponse(message) {
     if (message.type === "roster" && message.method === "list") {
-      return {
-        type: "roster",
-        data: JSON.parse(JSON.stringify(mockData.roster.list))
-      };
+      const all = JSON.parse(JSON.stringify(mockData.roster.list));
+      const group = message.params?.group;
+      if (group) {
+        return {
+          type: "roster",
+          data: all.filter((e) => e.data.rosterGroups?.includes(group))
+        };
+      }
+      return { type: "roster", data: all };
     }
+    return { type: "roster", data: [] };
+  }
+  /**
+   * Get roster group response
+   */
+  getRosterGroupResponse() {
     return {
-      type: "roster",
-      data: []
+      type: "rosterGroup",
+      data: JSON.parse(JSON.stringify(mockData.rosterGroup.list))
     };
   }
   /**
@@ -795,13 +818,11 @@ var MockResponseManager = class {
         F1: false,
         F2: false,
         F3: false,
-        F4: false
+        F4: false,
+        ...data.prefix !== void 0 && { prefix: data.prefix }
       };
       this.throttles.set(throttleId, throttleState);
-      return {
-        type: "throttle",
-        data: { ...throttleState }
-      };
+      return { type: "throttle", data: { ...throttleState } };
     }
     if (data.release !== void 0 && data.throttle) {
       this.throttles.delete(data.throttle);
@@ -934,6 +955,7 @@ var MockResponseManager = class {
    */
   reset() {
     this.powerState = 4 /* OFF */;
+    this.powerStateByPrefix.clear();
     this.throttles.clear();
     this.lights = /* @__PURE__ */ new Map([
       ["IL1", 4 /* OFF */],
@@ -1418,6 +1440,32 @@ var RosterManager = class {
     }
     return results;
   }
+  /**
+   * Get all roster groups
+   */
+  async getRosterGroups() {
+    const message = {
+      type: "rosterGroup",
+      method: "list"
+    };
+    const response = await this.client.request(message);
+    if (!response.data) return [];
+    return response.data.map((wrapper) => wrapper.data);
+  }
+  /**
+   * Get roster entries belonging to a specific group
+   */
+  async getRosterEntriesByGroup(group) {
+    const message = {
+      type: "roster",
+      method: "list",
+      params: { group }
+    };
+    const response = await this.client.request(message);
+    if (!response.data) return [];
+    const entries = response.data;
+    return entries.filter((e) => e.type === "rosterEntry");
+  }
   /**
    * Get cached roster (no network request)
    */
@@ -2130,6 +2178,18 @@ var JmriClient = class extends EventEmitter10 {
   async searchRoster(query) {
     return this.rosterManager.searchRoster(query);
   }
+  /**
+   * Get all roster groups
+   */
+  async getRosterGroups() {
+    return this.rosterManager.getRosterGroups();
+  }
+  /**
+   * Get roster entries belonging to a specific group
+   */
+  async getRosterEntriesByGroup(group) {
+    return this.rosterManager.getRosterEntriesByGroup(group);
+  }
   // ============================================================================
   // Turnout Control
   // ============================================================================

package/dist/types/client.d.ts

@@ -4,7 +4,7 @@
 import { EventEmitter } from 'eventemitter3';
 import { WebSocketClient } from './core/websocket-client.js';
 import { PartialClientOptions } from './types/client-options.js';
-import { PowerState, RosterEntryWrapper, TurnoutState, TurnoutData, LightState, LightData, SystemConnectionData } from './types/jmri-messages.js';
+import { PowerState, RosterEntryWrapper, RosterGroup, TurnoutState, TurnoutData, LightState, LightData, SystemConnectionData } from './types/jmri-messages.js';
 import { ConnectionState } from './types/events.js';
 import { ThrottleAcquireOptions, ThrottleFunctionKey, ThrottleState } from './types/throttle.js';
 /**
@@ -104,6 +104,14 @@ export declare class JmriClient extends EventEmitter {
      * Search roster by partial name match
      */
     searchRoster(query: string): Promise<RosterEntryWrapper[]>;
+    /**
+     * Get all roster groups
+     */
+    getRosterGroups(): Promise<RosterGroup[]>;
+    /**
+     * Get roster entries belonging to a specific group
+     */
+    getRosterEntriesByGroup(group: string): Promise<RosterEntryWrapper[]>;
     /**
      * Get the current state of a turnout
      */

package/dist/types/index.d.ts

@@ -4,7 +4,7 @@
  */
 export { JmriClient } from './client.js';
 export { WebSocketClient } from './core/websocket-client.js';
-export { JmriClientOptions, PartialClientOptions, ReconnectionOptions, HeartbeatOptions, MockOptions, PowerState, TurnoutState, LightState, RosterEntry, TurnoutData, LightData, JmriMessage, PowerMessage, TurnoutMessage, LightMessage, ThrottleMessage, RosterMessage, ConnectionState, EventPayloads, ThrottleAcquireOptions, ThrottleFunctionKey, ThrottleState } from './types/index.js';
+export { JmriClientOptions, PartialClientOptions, ReconnectionOptions, HeartbeatOptions, MockOptions, PowerState, TurnoutState, LightState, RosterEntry, RosterGroup, TurnoutData, LightData, JmriMessage, PowerMessage, TurnoutMessage, LightMessage, ThrottleMessage, RosterMessage, ConnectionState, EventPayloads, ThrottleAcquireOptions, ThrottleFunctionKey, ThrottleState } from './types/index.js';
 export { isThrottleFunctionKey, isValidSpeed } from './types/throttle.js';
 export { powerStateToString, turnoutStateToString, lightStateToString } from './types/jmri-messages.js';
 export { MockResponseManager, mockResponseManager, mockData } from './mocks/index.js';

package/dist/types/managers/roster-manager.d.ts

@@ -2,7 +2,7 @@
  * Roster management
  */
 import { WebSocketClient } from '../core/websocket-client.js';
-import { RosterEntryWrapper } from '../types/jmri-messages.js';
+import { RosterEntryWrapper, RosterGroup } from '../types/jmri-messages.js';
 /**
  * Manages locomotive roster
  */
@@ -26,6 +26,14 @@ export declare class RosterManager {
      * Search roster by partial name match
      */
     searchRoster(query: string): Promise<RosterEntryWrapper[]>;
+    /**
+     * Get all roster groups
+     */
+    getRosterGroups(): Promise<RosterGroup[]>;
+    /**
+     * Get roster entries belonging to a specific group
+     */
+    getRosterEntriesByGroup(group: string): Promise<RosterEntryWrapper[]>;
     /**
      * Get cached roster (no network request)
      */

package/dist/types/mocks/mock-data.d.ts

@@ -96,8 +96,11 @@ export declare const mockData: {
                     readonly icon: null;
                     readonly selectedIcon: null;
                 }];
-                readonly attributes: readonly [];
-                readonly rosterGroups: readonly [];
+                readonly attributes: readonly [{
+                    readonly name: "RosterGroup:diesels";
+                    readonly value: "yes";
+                }];
+                readonly rosterGroups: readonly ["diesels"];
             };
             readonly id: 1;
         }, {
@@ -150,8 +153,11 @@ export declare const mockData: {
                     readonly icon: null;
                     readonly selectedIcon: null;
                 }];
-                readonly attributes: readonly [];
-                readonly rosterGroups: readonly [];
+                readonly attributes: readonly [{
+                    readonly name: "RosterGroup:steam";
+                    readonly value: "yes";
+                }];
+                readonly rosterGroups: readonly ["steam"];
             };
             readonly id: 2;
         }, {
@@ -210,12 +216,30 @@ export declare const mockData: {
                     readonly icon: null;
                     readonly selectedIcon: null;
                 }];
-                readonly attributes: readonly [];
-                readonly rosterGroups: readonly [];
+                readonly attributes: readonly [{
+                    readonly name: "RosterGroup:diesels";
+                    readonly value: "yes";
+                }];
+                readonly rosterGroups: readonly ["diesels"];
             };
             readonly id: 3;
         }];
     };
+    readonly rosterGroup: {
+        readonly list: readonly [{
+            readonly type: "rosterGroup";
+            readonly data: {
+                readonly name: "diesels";
+                readonly length: 2;
+            };
+        }, {
+            readonly type: "rosterGroup";
+            readonly data: {
+                readonly name: "steam";
+                readonly length: 1;
+            };
+        }];
+    };
     readonly throttle: {
         readonly acquire: {
             readonly success: {

package/dist/types/mocks/mock-response-manager.d.ts

@@ -20,6 +20,7 @@ export interface MockResponseManagerOptions {
 export declare class MockResponseManager {
     private responseDelay;
     private powerState;
+    private powerStateByPrefix;
     private throttles;
     private lights;
     private turnouts;
@@ -33,13 +34,17 @@ export declare class MockResponseManager {
      */
     private getHelloResponse;
     /**
-     * Get power response
+     * Get power response, with optional per-prefix state tracking
      */
     private getPowerResponse;
     /**
-     * Get roster response
+     * Get roster response, optionally filtered by group
      */
     private getRosterResponse;
+    /**
+     * Get roster group response
+     */
+    private getRosterGroupResponse;
     /**
      * Get throttle response
      */

package/dist/types/types/jmri-messages.d.ts

@@ -10,6 +10,7 @@ export interface JmriMessage {
     method?: 'get' | 'post' | 'put' | 'delete' | 'list';
     data?: any;
     id?: number;
+    params?: Record<string, string>;
 }
 /**
  * Power state values (from JMRI JSON protocol constants)
@@ -166,6 +167,27 @@ export interface RosterMessage extends JmriMessage {
 export interface RosterData {
     [key: string]: RosterEntry;
 }
+export interface RosterGroup {
+    name: string;
+    length: number;
+}
+export interface RosterGroupWrapper {
+    type: 'rosterGroup';
+    data: RosterGroup;
+}
+export interface RosterGroupMessage extends JmriMessage {
+    type: 'rosterGroup';
+    method: 'list';
+    data?: RosterGroupWrapper[];
+}
+export interface RosterMessageWithParams extends JmriMessage {
+    type: 'roster';
+    method: 'list';
+    params?: {
+        group: string;
+    };
+    data?: RosterResponse;
+}
 /**
  * Turnout state values (from JMRI JSON protocol constants)
  * UNKNOWN = 0 (state cannot be determined)

package/docs/API.md

@@ -141,6 +141,13 @@ const entry = await client.getRosterEntryByAddress(3);
 
 // Search roster
 const results = await client.searchRoster('steam');
+
+// Get all roster groups
+const groups: RosterGroup[] = await client.getRosterGroups();
+// [{ name: 'locos', length: 3 }, { name: 'trams', length: 2 }]
+
+// Get roster entries for a specific group
+const locos = await client.getRosterEntriesByGroup('locos');
 ```
 
 ## Light Control
@@ -267,6 +274,7 @@ import {
   LightState,
   LightData,
   RosterEntry,
+  RosterGroup,
   TurnoutState,
   TurnoutData,
   ThrottleState,

package/docs/MOCK_MODE.md

@@ -65,13 +65,18 @@ Connection establishment response with JMRI version info:
 Track power ON/OFF states
 
 ### Roster
-Three sample locomotives:
-- **CSX754** - GP38-2 diesel locomotive
-- **UP3985** - Challenger 4-6-6-4 steam locomotive
-- **BNSF5240** - SD40-2 diesel locomotive
+Three sample locomotives across two groups:
+- **CSX754** - GP38-2 diesel locomotive (`diesels` group)
+- **UP3985** - Challenger 4-6-6-4 steam locomotive (`steam` group)
+- **BNSF5240** - SD40-2 diesel locomotive (`diesels` group)
 
 Each includes realistic function key mappings (F0-F4).
 
+### Roster Groups
+Two sample groups:
+- **diesels** - CSX754, BNSF5240 (length: 2)
+- **steam** - UP3985 (length: 1)
+
 ### Lights
 Three sample lights:
 - **IL1** - Yard Light (OFF)
@@ -163,10 +168,10 @@ const response = await mockManager.getMockResponse({
 
 The mock system maintains state for realistic behavior:
 
-- **Power state** - Remembers if power is ON or OFF
+- **Power state** - Remembers if power is ON or OFF; tracked independently per connection prefix when one is supplied
 - **Light states** - Tracks ON/OFF state per light
 - **Turnout states** - Tracks CLOSED/THROWN state per turnout
-- **Throttles** - Tracks acquired throttles and their states
+- **Throttles** - Tracks acquired throttles and their states, including connection prefix
 - **Speed/Direction** - Maintains current speed and direction per throttle
 - **Functions** - Tracks function key states (F0-F28)
 
@@ -208,11 +213,12 @@ The mock data structure follows the JMRI JSON protocol specification.
 Mock mode implements the full JMRI client API. All methods work identically:
 
 - ✅ `connect()` / `disconnect()`
-- ✅ `getPower()` / `powerOn()` / `powerOff()`
-- ✅ `getRoster()`
+- ✅ `getPower()` / `powerOn()` / `powerOff()` (with optional prefix)
+- ✅ `getRoster()` / `getRosterEntryByName()` / `getRosterEntryByAddress()` / `searchRoster()`
+- ✅ `getRosterGroups()` / `getRosterEntriesByGroup()`
 - ✅ `getLight()` / `setLight()` / `turnOnLight()` / `turnOffLight()` / `listLights()`
 - ✅ `getTurnout()` / `setTurnout()` / `throwTurnout()` / `closeTurnout()` / `listTurnouts()`
-- ✅ `acquireThrottle()` / `releaseThrottle()`
+- ✅ `acquireThrottle()` / `releaseThrottle()` (with optional prefix)
 - ✅ `setThrottleSpeed()`
 - ✅ `setThrottleDirection()`
 - ✅ `setThrottleFunction()`

package/package.json

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