jmri-client 4.2.0-beta.1 → 5.0.0

package/dist/cjs/managers/roster-manager.js

@@ -1,118 +0,0 @@
-"use strict";
-/**
- * Roster management
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.RosterManager = void 0;
-/**
- * Manages locomotive roster
- */
-class RosterManager {
-    constructor(client) {
-        this.rosterCache = new Map();
-        this.client = client;
-    }
-    /**
-     * Get all roster entries
-     */
-    async getRoster() {
-        const message = {
-            type: 'roster',
-            method: 'list'
-        };
-        const response = await this.client.request(message);
-        // Parse roster data
-        if (response.data) {
-            this.updateCache(response.data);
-        }
-        return Array.from(this.rosterCache.values());
-    }
-    /**
-     * Get roster entry by name
-     */
-    async getRosterEntryByName(name) {
-        // Check cache first
-        if (this.rosterCache.has(name)) {
-            return this.rosterCache.get(name);
-        }
-        // Refresh roster
-        await this.getRoster();
-        return this.rosterCache.get(name);
-    }
-    /**
-     * Get roster entry by address
-     */
-    async getRosterEntryByAddress(address) {
-        // Ensure roster is loaded
-        if (this.rosterCache.size === 0) {
-            await this.getRoster();
-        }
-        const addressStr = address.toString();
-        for (const wrapper of this.rosterCache.values()) {
-            if (wrapper.data.address === addressStr) {
-                return wrapper;
-            }
-        }
-        return undefined;
-    }
-    /**
-     * Search roster by partial name match
-     */
-    async searchRoster(query) {
-        // Ensure roster is loaded
-        if (this.rosterCache.size === 0) {
-            await this.getRoster();
-        }
-        const lowerQuery = query.toLowerCase();
-        const results = [];
-        for (const wrapper of this.rosterCache.values()) {
-            const entry = wrapper.data;
-            if (entry.name.toLowerCase().includes(lowerQuery) ||
-                entry.address.includes(query) ||
-                entry.road?.toLowerCase().includes(lowerQuery) ||
-                entry.number?.includes(query)) {
-                results.push(wrapper);
-            }
-        }
-        return results;
-    }
-    /**
-     * Get cached roster (no network request)
-     */
-    getCachedRoster() {
-        return Array.from(this.rosterCache.values());
-    }
-    /**
-     * Clear roster cache
-     */
-    clearCache() {
-        this.rosterCache.clear();
-    }
-    /**
-     * Update internal cache from roster data
-     */
-    updateCache(rosterData) {
-        this.rosterCache.clear();
-        // Handle array format (real JMRI server) - store wrapped entries
-        if (Array.isArray(rosterData)) {
-            for (const wrapper of rosterData) {
-                if (wrapper.type === 'rosterEntry' && wrapper.data) {
-                    this.rosterCache.set(wrapper.data.name, wrapper);
-                }
-            }
-        }
-        // Handle legacy keyed object format (for backward compatibility) - wrap entries
-        else {
-            let id = 1;
-            for (const [name, entry] of Object.entries(rosterData)) {
-                const wrapper = {
-                    type: 'rosterEntry',
-                    data: entry,
-                    id: id++
-                };
-                this.rosterCache.set(name, wrapper);
-            }
-        }
-    }
-}
-exports.RosterManager = RosterManager;

package/dist/cjs/managers/system-connections-manager.js

@@ -1,28 +0,0 @@
-"use strict";
-/**
- * System connections manager — discovers available JMRI hardware connection prefixes
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SystemConnectionsManager = void 0;
-class SystemConnectionsManager {
-    constructor(client) {
-        this.client = client;
-    }
-    /**
-     * List all available JMRI system connections and their prefixes.
-     * Use the returned prefix values with power and throttle commands to
-     * target a specific hardware connection when multiple are configured.
-     */
-    async getSystemConnections() {
-        const message = {
-            type: 'systemConnections',
-            method: 'list'
-        };
-        const response = await this.client.request(message);
-        if (!response.data) {
-            return [];
-        }
-        return Array.isArray(response.data) ? response.data : [response.data];
-    }
-}
-exports.SystemConnectionsManager = SystemConnectionsManager;

package/dist/cjs/managers/throttle-manager.js

@@ -1,233 +0,0 @@
-"use strict";
-/**
- * Throttle control manager
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ThrottleManager = void 0;
-const eventemitter3_1 = require("eventemitter3");
-const throttle_js_1 = require("../types/throttle.js");
-/**
- * Manages multiple throttles
- */
-class ThrottleManager extends eventemitter3_1.EventEmitter {
-    constructor(client) {
-        super();
-        this.throttles = new Map();
-        this.client = client;
-        // Generate a unique client ID
-        this.clientId = `jmri-client-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
-        // Listen for throttle updates
-        this.client.on('update', (message) => {
-            if (message.type === 'throttle') {
-                this.handleThrottleUpdate(message);
-            }
-        });
-        // Clean up throttles on disconnect
-        this.client.on('disconnected', () => {
-            this.handleDisconnect();
-        });
-    }
-    /**
-     * Acquire a throttle for a locomotive
-     */
-    async acquireThrottle(options) {
-        // Generate a unique throttle name using client ID and address
-        const throttleName = `${this.clientId}-${options.address}`;
-        const message = {
-            type: 'throttle',
-            data: {
-                name: throttleName,
-                address: options.address,
-                ...(options.prefix !== undefined && { prefix: options.prefix })
-            }
-        };
-        const response = await this.client.request(message);
-        // JMRI returns the throttle ID in the "throttle" field, or we can use our name
-        const throttleId = response.data?.throttle || throttleName;
-        if (!throttleId) {
-            throw new Error('Failed to acquire throttle: no throttle ID returned');
-        }
-        // Initialize throttle state
-        const state = {
-            id: throttleId,
-            address: options.address,
-            speed: 0,
-            forward: true,
-            functions: new Map(),
-            acquired: true
-        };
-        this.throttles.set(throttleId, state);
-        this.emit('throttle:acquired', throttleId);
-        return throttleId;
-    }
-    /**
-     * Release a throttle
-     */
-    async releaseThrottle(throttleId) {
-        const state = this.throttles.get(throttleId);
-        if (!state) {
-            throw new Error(`Throttle not found: ${throttleId}`);
-        }
-        const message = {
-            type: 'throttle',
-            data: {
-                throttle: throttleId,
-                release: null
-            }
-        };
-        await this.client.request(message);
-        this.throttles.delete(throttleId);
-        this.emit('throttle:released', throttleId);
-    }
-    /**
-     * Set throttle speed (0.0 to 1.0)
-     */
-    async setSpeed(throttleId, speed) {
-        const state = this.throttles.get(throttleId);
-        if (!state) {
-            throw new Error(`Throttle not found: ${throttleId}`);
-        }
-        if (!(0, throttle_js_1.isValidSpeed)(speed)) {
-            throw new Error(`Invalid speed: ${speed}. Must be between 0.0 and 1.0`);
-        }
-        const message = {
-            type: 'throttle',
-            data: {
-                throttle: throttleId,
-                speed
-            }
-        };
-        // JMRI doesn't send responses for throttle control commands, just send
-        this.client.send(message);
-        state.speed = speed;
-        this.emit('throttle:updated', throttleId, { speed });
-    }
-    /**
-     * Set throttle direction
-     */
-    async setDirection(throttleId, forward) {
-        const state = this.throttles.get(throttleId);
-        if (!state) {
-            throw new Error(`Throttle not found: ${throttleId}`);
-        }
-        const message = {
-            type: 'throttle',
-            data: {
-                throttle: throttleId,
-                forward
-            }
-        };
-        // JMRI doesn't send responses for throttle control commands, just send
-        this.client.send(message);
-        state.forward = forward;
-        this.emit('throttle:updated', throttleId, { forward });
-    }
-    /**
-     * Set throttle function (F0-F28)
-     */
-    async setFunction(throttleId, functionKey, value) {
-        const state = this.throttles.get(throttleId);
-        if (!state) {
-            throw new Error(`Throttle not found: ${throttleId}`);
-        }
-        if (!(0, throttle_js_1.isThrottleFunctionKey)(functionKey)) {
-            throw new Error(`Invalid function key: ${functionKey}`);
-        }
-        const data = {
-            throttle: throttleId,
-            [functionKey]: value
-        };
-        const message = {
-            type: 'throttle',
-            data
-        };
-        // JMRI doesn't send responses for throttle control commands, just send
-        this.client.send(message);
-        state.functions.set(functionKey, value);
-        this.emit('throttle:updated', throttleId, { [functionKey]: value });
-    }
-    /**
-     * Emergency stop for a throttle (speed to 0)
-     */
-    async emergencyStop(throttleId) {
-        await this.setSpeed(throttleId, 0);
-    }
-    /**
-     * Set throttle to idle (speed to 0, maintain direction)
-     */
-    async idle(throttleId) {
-        await this.setSpeed(throttleId, 0);
-    }
-    /**
-     * Get throttle state
-     */
-    getThrottleState(throttleId) {
-        return this.throttles.get(throttleId);
-    }
-    /**
-     * Get all throttle IDs
-     */
-    getThrottleIds() {
-        return Array.from(this.throttles.keys());
-    }
-    /**
-     * Get all throttle states
-     */
-    getAllThrottles() {
-        return Array.from(this.throttles.values());
-    }
-    /**
-     * Release all throttles
-     */
-    async releaseAllThrottles() {
-        const throttleIds = this.getThrottleIds();
-        for (const throttleId of throttleIds) {
-            try {
-                await this.releaseThrottle(throttleId);
-            }
-            catch (error) {
-                // Continue releasing others even if one fails
-                this.emit('error', error);
-            }
-        }
-    }
-    /**
-     * Handle unsolicited throttle updates from JMRI
-     */
-    handleThrottleUpdate(message) {
-        const throttleId = message.data?.throttle;
-        if (!throttleId) {
-            return;
-        }
-        const state = this.throttles.get(throttleId);
-        if (!state) {
-            // Unknown throttle, possibly lost
-            this.emit('throttle:lost', throttleId);
-            return;
-        }
-        // Update state from message
-        if (message.data.speed !== undefined) {
-            state.speed = message.data.speed;
-        }
-        if (message.data.forward !== undefined) {
-            state.forward = message.data.forward;
-        }
-        // Update functions
-        for (let i = 0; i <= 28; i++) {
-            const key = `F${i}`;
-            if (message.data[key] !== undefined) {
-                state.functions.set(key, message.data[key]);
-            }
-        }
-        this.emit('throttle:updated', throttleId, message.data);
-    }
-    /**
-     * Handle disconnect - mark all throttles as not acquired
-     */
-    handleDisconnect() {
-        for (const state of this.throttles.values()) {
-            state.acquired = false;
-        }
-    }
-}
-exports.ThrottleManager = ThrottleManager;

package/dist/cjs/managers/turnout-manager.js

@@ -1,111 +0,0 @@
-"use strict";
-/**
- * Turnout (switch) manager
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TurnoutManager = void 0;
-const eventemitter3_1 = require("eventemitter3");
-const jmri_messages_js_1 = require("../types/jmri-messages.js");
-/**
- * Manages JMRI turnout (track switch) state
- */
-class TurnoutManager extends eventemitter3_1.EventEmitter {
-    constructor(client) {
-        super();
-        this.turnouts = new Map();
-        this.client = client;
-        this.client.on('update', (message) => {
-            if (message.type === 'turnout') {
-                this.handleTurnoutUpdate(message);
-            }
-        });
-    }
-    /**
-     * Get the current state of a turnout.
-     * Also registers a server-side listener so subsequent changes are pushed.
-     */
-    async getTurnout(name) {
-        const message = {
-            type: 'turnout',
-            data: { name }
-        };
-        const response = await this.client.request(message);
-        const state = response.data?.state ?? jmri_messages_js_1.TurnoutState.UNKNOWN;
-        this.turnouts.set(name, state);
-        return state;
-    }
-    /**
-     * Set a turnout to the given state
-     */
-    async setTurnout(name, state) {
-        const message = {
-            type: 'turnout',
-            method: 'post',
-            data: { name, state }
-        };
-        await this.client.request(message);
-        const oldState = this.turnouts.get(name);
-        this.turnouts.set(name, state);
-        if (oldState !== state) {
-            this.emit('turnout:changed', name, state);
-        }
-    }
-    /**
-     * Throw a turnout (diverging route)
-     */
-    async throwTurnout(name) {
-        return this.setTurnout(name, jmri_messages_js_1.TurnoutState.THROWN);
-    }
-    /**
-     * Close a turnout (straight through / normal)
-     */
-    async closeTurnout(name) {
-        return this.setTurnout(name, jmri_messages_js_1.TurnoutState.CLOSED);
-    }
-    /**
-     * List all turnouts known to JMRI
-     */
-    async listTurnouts() {
-        const message = {
-            type: 'turnout',
-            method: 'list'
-        };
-        const response = await this.client.request(message);
-        const entries = Array.isArray(response?.data)
-            ? response.data.map((r) => r.data ?? r)
-            : [];
-        for (const entry of entries) {
-            if (entry.name && entry.state !== undefined) {
-                this.turnouts.set(entry.name, entry.state);
-            }
-        }
-        return entries;
-    }
-    /**
-     * Get cached turnout state without a network request
-     */
-    getTurnoutState(name) {
-        return this.turnouts.get(name);
-    }
-    /**
-     * Get all cached turnout states
-     */
-    getCachedTurnouts() {
-        return new Map(this.turnouts);
-    }
-    /**
-     * Handle unsolicited turnout state updates from JMRI
-     */
-    handleTurnoutUpdate(message) {
-        const name = message.data?.name;
-        const state = message.data?.state;
-        if (!name || state === undefined)
-            return;
-        const oldState = this.turnouts.get(name);
-        this.turnouts.set(name, state);
-        if (oldState !== state) {
-            this.emit('turnout:changed', name, state);
-        }
-    }
-}
-exports.TurnoutManager = TurnoutManager;

package/dist/cjs/mocks/index.js

@@ -1,12 +0,0 @@
-"use strict";
-/**
- * Mock system exports
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.mockData = exports.mockResponseManager = exports.MockResponseManager = void 0;
-var mock_response_manager_js_1 = require("./mock-response-manager.js");
-Object.defineProperty(exports, "MockResponseManager", { enumerable: true, get: function () { return mock_response_manager_js_1.MockResponseManager; } });
-Object.defineProperty(exports, "mockResponseManager", { enumerable: true, get: function () { return mock_response_manager_js_1.mockResponseManager; } });
-// Re-export mock data for direct access if needed
-var mock_data_js_1 = require("./mock-data.js");
-Object.defineProperty(exports, "mockData", { enumerable: true, get: function () { return mock_data_js_1.mockData; } });