@ya-modbus/cli 0.4.1-refactor-scope-driver-packages.0

package/dist/src/discovery/parameter-generator.js

@@ -0,0 +1,184 @@
+import { MAX_SLAVE_ID, MIN_SLAVE_ID } from './constants.js';
+import { getParameterArrays } from './parameter-generator-utils.js';
+/**
+ * Clamp slave ID to valid Modbus range [1, 247]
+ */
+function clampSlaveId(id) {
+    return Math.max(MIN_SLAVE_ID, Math.min(MAX_SLAVE_ID, id));
+}
+/**
+ * Generate ordered list of slave IDs to test
+ *
+ * Priority order:
+ * 1. Default address (if provided)
+ * 2. Address 1 (most common)
+ * 3. Address 2
+ * 4. Remaining addresses sequentially (3, 4, 5, ...)
+ */
+function* generateSlaveIds(range, defaultAddress) {
+    const [minId, maxId] = range;
+    const start = clampSlaveId(minId);
+    const end = clampSlaveId(maxId);
+    const yielded = new Set();
+    // Helper to yield if not already yielded and in range
+    function* yieldIfValid(id) {
+        const clamped = clampSlaveId(id);
+        if (clamped >= start && clamped <= end && !yielded.has(clamped)) {
+            yielded.add(clamped);
+            yield clamped;
+        }
+    }
+    // 1. Default address first
+    if (defaultAddress !== undefined) {
+        yield* yieldIfValid(defaultAddress);
+    }
+    // 2. Common addresses (1, 2)
+    yield* yieldIfValid(1);
+    yield* yieldIfValid(2);
+    // 3. Remaining addresses sequentially
+    for (let id = start; id <= end; id++) {
+        if (!yielded.has(id)) {
+            yielded.add(id);
+            yield id;
+        }
+    }
+}
+/**
+ * Prioritize default configuration values in parameter arrays
+ *
+ * Moves default values to the front of arrays while preserving uniqueness
+ */
+function prioritizeDefaults(array, defaultValue) {
+    if (defaultValue === undefined || !array.includes(defaultValue)) {
+        return array;
+    }
+    // Move default to front, remove duplicates
+    return [defaultValue, ...array.filter((v) => v !== defaultValue)];
+}
+/**
+ * Generate parameter combinations grouped by serial configuration
+ *
+ * This is a memory-efficient alternative to materializing all combinations.
+ * Instead of creating all ~1500+ combinations at once, this generator yields
+ * groups of ~247 combinations at a time (one per serial config).
+ *
+ * Each group shares the same serial parameters (baud, parity, data bits, stop bits)
+ * but has different slave IDs. This matches how the scanner works - it creates
+ * one connection per serial config and tests all slave IDs with that connection.
+ *
+ * @param options - Generation options
+ * @yields Parameter groups to test
+ *
+ * @example Iterate over groups without materializing all combinations
+ * ```typescript
+ * for (const group of generateParameterGroups(options)) {
+ *   // Only this group's ~247 combinations are in memory
+ *   const { serialParams, combinations } = group
+ *   // ... use combinations ...
+ * }
+ * ```
+ */
+export function* generateParameterGroups(options) {
+    const { strategy, defaultConfig, supportedConfig } = options;
+    // Get parameter arrays
+    let { baudRates, parities, dataBits, stopBits } = getParameterArrays(strategy, supportedConfig);
+    const { addressRange } = getParameterArrays(strategy, supportedConfig);
+    // Prioritize default values to test them first
+    if (defaultConfig) {
+        baudRates = prioritizeDefaults(baudRates, defaultConfig.baudRate);
+        parities = prioritizeDefaults(parities, defaultConfig.parity);
+        dataBits = prioritizeDefaults(dataBits, defaultConfig.dataBits);
+        stopBits = prioritizeDefaults(stopBits, defaultConfig.stopBits);
+    }
+    // Generate slave IDs once (reused for each serial config)
+    const slaveIds = Array.from(generateSlaveIds(addressRange, defaultConfig?.defaultAddress));
+    // Generate groups: iterate serial params (baud × parity × data × stop)
+    // For each serial config, create a group with all slave IDs
+    for (const baudRate of baudRates) {
+        for (const parity of parities) {
+            for (const dataBits_ of dataBits) {
+                for (const stopBits_ of stopBits) {
+                    // Build combinations for this serial config
+                    const combinations = slaveIds.map((slaveId) => ({
+                        slaveId,
+                        baudRate,
+                        parity,
+                        dataBits: dataBits_,
+                        stopBits: stopBits_,
+                    }));
+                    yield {
+                        serialParams: {
+                            baudRate,
+                            parity,
+                            dataBits: dataBits_,
+                            stopBits: stopBits_,
+                        },
+                        combinations,
+                    };
+                }
+            }
+        }
+    }
+}
+/**
+ * Generate all parameter combinations for Modbus device discovery
+ *
+ * Produces combinations in priority order:
+ * 1. Default configuration (if provided) tested first
+ * 2. Common slave addresses (1, 2) before others
+ * 3. Common baud rates before exotic ones
+ *
+ * @param options - Generation options
+ * @yields Parameter combinations to test
+ *
+ * @example Quick discovery with driver config
+ * ```typescript
+ * const combinations = generateParameterCombinations({
+ *   strategy: 'quick',
+ *   defaultConfig: { baudRate: 9600, parity: 'even', ... },
+ *   supportedConfig: { validBaudRates: [9600, 19200], ... }
+ * })
+ * ```
+ *
+ * @example Thorough discovery without driver
+ * ```typescript
+ * const combinations = generateParameterCombinations({
+ *   strategy: 'thorough'
+ * })
+ * ```
+ */
+export function* generateParameterCombinations(options) {
+    const { strategy, defaultConfig, supportedConfig } = options;
+    // Get parameter arrays
+    let { baudRates, parities, dataBits, stopBits } = getParameterArrays(strategy, supportedConfig);
+    const { addressRange } = getParameterArrays(strategy, supportedConfig);
+    // Prioritize default values to test them first
+    if (defaultConfig) {
+        baudRates = prioritizeDefaults(baudRates, defaultConfig.baudRate);
+        parities = prioritizeDefaults(parities, defaultConfig.parity);
+        dataBits = prioritizeDefaults(dataBits, defaultConfig.dataBits);
+        stopBits = prioritizeDefaults(stopBits, defaultConfig.stopBits);
+    }
+    // Generate combinations in priority order:
+    // - Default config combination first
+    // - Then iterate: slave IDs (prioritized) × baud rates (prioritized) × parity × data × stop
+    const slaveIds = Array.from(generateSlaveIds(addressRange, defaultConfig?.defaultAddress));
+    for (const slaveId of slaveIds) {
+        for (const baudRate of baudRates) {
+            for (const parity of parities) {
+                for (const dataBits_ of dataBits) {
+                    for (const stopBits_ of stopBits) {
+                        yield {
+                            slaveId,
+                            baudRate,
+                            parity,
+                            dataBits: dataBits_,
+                            stopBits: stopBits_,
+                        };
+                    }
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=parameter-generator.js.map

package/dist/src/discovery/parameter-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parameter-generator.js","sourceRoot":"","sources":["../../../src/discovery/parameter-generator.ts"],"names":[],"mappings":"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"}

package/dist/src/discovery/progress.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Simple progress tracker for discovery operations
+ */
+export declare class ProgressTracker {
+    private readonly totalCombinations;
+    private startTime;
+    private lastUpdateTime;
+    private readonly updateIntervalMs;
+    constructor(totalCombinations: number);
+    /**
+     * Update progress and return formatted status string
+     * Only returns a new string if enough time has passed since last update
+     *
+     * @param current - Current combination index
+     * @param devicesFound - Number of devices found so far
+     * @returns Progress string or null if no update needed
+     */
+    update(current: number, devicesFound: number): string | null;
+    /**
+     * Format duration in seconds to human-readable string
+     */
+    private formatDuration;
+}
+//# sourceMappingURL=progress.d.ts.map

package/dist/src/discovery/progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.d.ts","sourceRoot":"","sources":["../../../src/discovery/progress.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,eAAe;IAKd,OAAO,CAAC,QAAQ,CAAC,iBAAiB;IAJ9C,OAAO,CAAC,SAAS,CAAQ;IACzB,OAAO,CAAC,cAAc,CAAY;IAClC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAe;gBAEnB,iBAAiB,EAAE,MAAM;IAItD;;;;;;;OAOG;IACH,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAyB5D;;OAEG;IACH,OAAO,CAAC,cAAc;CAgBvB"}

package/dist/src/discovery/progress.js

@@ -0,0 +1,57 @@
+/**
+ * Simple progress tracker for discovery operations
+ */
+export class ProgressTracker {
+    totalCombinations;
+    startTime;
+    lastUpdateTime = 0;
+    updateIntervalMs = 1000; // Update every second
+    constructor(totalCombinations) {
+        this.totalCombinations = totalCombinations;
+        this.startTime = Date.now();
+    }
+    /**
+     * Update progress and return formatted status string
+     * Only returns a new string if enough time has passed since last update
+     *
+     * @param current - Current combination index
+     * @param devicesFound - Number of devices found so far
+     * @returns Progress string or null if no update needed
+     */
+    update(current, devicesFound) {
+        const now = Date.now();
+        // Throttle updates to avoid excessive console output
+        if (now - this.lastUpdateTime < this.updateIntervalMs && current < this.totalCombinations) {
+            return null;
+        }
+        this.lastUpdateTime = now;
+        const percentage = Math.round((current / this.totalCombinations) * 100);
+        const elapsed = Math.floor((now - this.startTime) / 1000);
+        // Calculate ETA
+        let eta = '';
+        if (current > 0 && current < this.totalCombinations && elapsed > 0) {
+            const rate = current / elapsed;
+            const remaining = this.totalCombinations - current;
+            const etaSeconds = Math.round(remaining / rate);
+            eta = ` | ETA: ${this.formatDuration(etaSeconds)}`;
+        }
+        return `Progress: ${percentage}% (${current}/${this.totalCombinations}) | Devices found: ${devicesFound} | Elapsed: ${this.formatDuration(elapsed)}${eta}`;
+    }
+    /**
+     * Format duration in seconds to human-readable string
+     */
+    formatDuration(seconds) {
+        if (seconds < 60) {
+            return `${seconds}s`;
+        }
+        const minutes = Math.floor(seconds / 60);
+        const remainingSeconds = seconds % 60;
+        if (minutes < 60) {
+            return `${minutes}m ${remainingSeconds}s`;
+        }
+        const hours = Math.floor(minutes / 60);
+        const remainingMinutes = minutes % 60;
+        return `${hours}h ${remainingMinutes}m`;
+    }
+}
+//# sourceMappingURL=progress.js.map

package/dist/src/discovery/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../../../src/discovery/progress.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,eAAe;IAKG;IAJrB,SAAS,CAAQ;IACjB,cAAc,GAAW,CAAC,CAAA;IACjB,gBAAgB,GAAW,IAAI,CAAA,CAAC,sBAAsB;IAEvE,YAA6B,iBAAyB;QAAzB,sBAAiB,GAAjB,iBAAiB,CAAQ;QACpD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;IAC7B,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,OAAe,EAAE,YAAoB;QAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;QAEtB,qDAAqD;QACrD,IAAI,GAAG,GAAG,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,gBAAgB,IAAI,OAAO,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC1F,OAAO,IAAI,CAAA;QACb,CAAC;QAED,IAAI,CAAC,cAAc,GAAG,GAAG,CAAA;QAEzB,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,GAAG,GAAG,CAAC,CAAA;QACvE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,CAAA;QAEzD,gBAAgB;QAChB,IAAI,GAAG,GAAG,EAAE,CAAA;QACZ,IAAI,OAAO,GAAG,CAAC,IAAI,OAAO,GAAG,IAAI,CAAC,iBAAiB,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YACnE,MAAM,IAAI,GAAG,OAAO,GAAG,OAAO,CAAA;YAC9B,MAAM,SAAS,GAAG,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAA;YAClD,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,CAAA;YAC/C,GAAG,GAAG,WAAW,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,EAAE,CAAA;QACpD,CAAC;QAED,OAAO,aAAa,UAAU,MAAM,OAAO,IAAI,IAAI,CAAC,iBAAiB,sBAAsB,YAAY,eAAe,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,GAAG,GAAG,EAAE,CAAA;IAC5J,CAAC;IAED;;OAEG;IACK,cAAc,CAAC,OAAe;QACpC,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC;YACjB,OAAO,GAAG,OAAO,GAAG,CAAA;QACtB,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAA;QACxC,MAAM,gBAAgB,GAAG,OAAO,GAAG,EAAE,CAAA;QAErC,IAAI,OAAO,GAAG,EAAE,EAAE,CAAC;YACjB,OAAO,GAAG,OAAO,KAAK,gBAAgB,GAAG,CAAA;QAC3C,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,GAAG,EAAE,CAAC,CAAA;QACtC,MAAM,gBAAgB,GAAG,OAAO,GAAG,EAAE,CAAA;QACrC,OAAO,GAAG,KAAK,KAAK,gBAAgB,GAAG,CAAA;IACzC,CAAC;CACF"}

package/dist/src/discovery/scanner.d.ts

@@ -0,0 +1,46 @@
+import { type DeviceIdentificationResult } from './device-identifier.js';
+import { type GeneratorOptions, type ParameterCombination } from './parameter-generator.js';
+/**
+ * Discovered device with full configuration
+ */
+export interface DiscoveredDevice extends ParameterCombination {
+    /** Device identification result */
+    identification: DeviceIdentificationResult;
+}
+/**
+ * Scanner options
+ */
+export interface ScanOptions {
+    /** Serial port path (e.g., /dev/ttyUSB0) */
+    port: string;
+    /** Response timeout in milliseconds */
+    timeout: number;
+    /** Delay between attempts in milliseconds */
+    delayMs: number;
+    /** Maximum number of devices to find (0 for unlimited, default: 1) */
+    maxDevices?: number;
+    /** Verbose progress - show current parameters being tested */
+    verbose?: boolean;
+    /** Progress callback (current index, total combinations, devices found) */
+    onProgress?: (current: number, total: number, devicesFound: number) => void;
+    /** Device found callback */
+    onDeviceFound?: (device: DiscoveredDevice) => void;
+    /** Verbose progress callback - called for each test attempt */
+    onTestAttempt?: (params: ParameterCombination, result: 'testing' | 'found' | 'not-found') => void;
+}
+/**
+ * Scan for Modbus devices using given parameter combinations
+ *
+ * **Performance Optimization**: Uses grouped generator to avoid materializing
+ * all combinations. Groups by serial parameters to reuse connections,
+ * reducing overhead from ~600ms to ~100ms per test.
+ *
+ * **Memory Efficiency**: Only materializes one group (~247 combinations) at a time
+ * instead of all ~1500+ combinations.
+ *
+ * @param generatorOptions - Options for parameter combination generation
+ * @param scanOptions - Scanning options
+ * @returns Array of discovered devices
+ */
+export declare function scanForDevices(generatorOptions: GeneratorOptions, scanOptions: ScanOptions): Promise<DiscoveredDevice[]>;
+//# sourceMappingURL=scanner.d.ts.map

package/dist/src/discovery/scanner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../../src/discovery/scanner.ts"],"names":[],"mappings":"AAEA,OAAO,EAAkB,KAAK,0BAA0B,EAAE,MAAM,wBAAwB,CAAA;AAExF,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EAC1B,MAAM,0BAA0B,CAAA;AAEjC;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,oBAAoB;IAC5D,mCAAmC;IACnC,cAAc,EAAE,0BAA0B,CAAA;CAC3C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAA;IAEZ,uCAAuC;IACvC,OAAO,EAAE,MAAM,CAAA;IAEf,6CAA6C;IAC7C,OAAO,EAAE,MAAM,CAAA;IAEf,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAA;IAEnB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAA;IAEjB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAA;IAE3E,4BAA4B;IAC5B,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,gBAAgB,KAAK,IAAI,CAAA;IAElD,+DAA+D;IAC/D,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,oBAAoB,EAAE,MAAM,EAAE,SAAS,GAAG,OAAO,GAAG,WAAW,KAAK,IAAI,CAAA;CAClG;AAsCD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,cAAc,CAClC,gBAAgB,EAAE,gBAAgB,EAClC,WAAW,EAAE,WAAW,GACvB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAsH7B"}

package/dist/src/discovery/scanner.js

@@ -0,0 +1,143 @@
+import ModbusRTU from 'modbus-serial';
+import { identifyDevice } from './device-identifier.js';
+import { countParameterCombinations } from './parameter-generator-utils.js';
+import { generateParameterGroups, } from './parameter-generator.js';
+/**
+ * Apply inter-test delay to prevent bus contention
+ *
+ * When a device is found, waits full delayMs for bus recovery.
+ * When no device found or error, waits remainder (delayMs - timeout) since
+ * timeout already consumed time waiting for response.
+ *
+ * @param delayMs - Configured delay between tests
+ * @param timeout - Request timeout in milliseconds
+ * @param deviceFound - Whether a device was found (true) or not found/error (false)
+ * @param shouldContinue - Whether scanning will continue after this delay
+ */
+async function applyInterTestDelay(delayMs, timeout, deviceFound, shouldContinue) {
+    // Skip delay if not continuing (reached maxDevices)
+    if (!shouldContinue) {
+        return;
+    }
+    if (deviceFound) {
+        // Device found - wait full delay for bus recovery
+        if (delayMs > 0) {
+            await new Promise((resolve) => setTimeout(resolve, delayMs));
+        }
+    }
+    else {
+        // No device or error - timeout already consumed time, wait remainder
+        if (delayMs > timeout) {
+            await new Promise((resolve) => setTimeout(resolve, delayMs - timeout));
+        }
+    }
+}
+/**
+ * Scan for Modbus devices using given parameter combinations
+ *
+ * **Performance Optimization**: Uses grouped generator to avoid materializing
+ * all combinations. Groups by serial parameters to reuse connections,
+ * reducing overhead from ~600ms to ~100ms per test.
+ *
+ * **Memory Efficiency**: Only materializes one group (~247 combinations) at a time
+ * instead of all ~1500+ combinations.
+ *
+ * @param generatorOptions - Options for parameter combination generation
+ * @param scanOptions - Scanning options
+ * @returns Array of discovered devices
+ */
+export async function scanForDevices(generatorOptions, scanOptions) {
+    const { port, timeout, delayMs, maxDevices = 1, verbose = false, onProgress, onDeviceFound, onTestAttempt, } = scanOptions;
+    // Calculate total combinations efficiently (no materialization)
+    const total = countParameterCombinations(generatorOptions);
+    const discovered = [];
+    let currentIndex = 0;
+    // Test each serial parameter group
+    // Generator yields groups without materializing all combinations
+    for (const group of generateParameterGroups(generatorOptions)) {
+        const { serialParams, combinations: groupCombinations } = group;
+        // Stop if we've found enough devices
+        if (maxDevices > 0 && discovered.length >= maxDevices) {
+            break;
+        }
+        // Get serial params from group
+        const { baudRate, parity, dataBits, stopBits } = serialParams;
+        try {
+            // Create and connect once for this serial parameter set
+            const client = new ModbusRTU();
+            await client.connectRTUBuffered(port, {
+                baudRate,
+                parity,
+                dataBits,
+                stopBits,
+            });
+            // Set timeout once for this connection
+            client.setTimeout(timeout);
+            try {
+                // Test all slave IDs with this serial configuration
+                for (const combination of groupCombinations) {
+                    // Stop if we've found enough devices
+                    if (maxDevices > 0 && discovered.length >= maxDevices) {
+                        break;
+                    }
+                    const { slaveId } = combination;
+                    try {
+                        // Notify verbose progress
+                        onTestAttempt?.(combination, 'testing');
+                        // Set slave ID (reusing same connection)
+                        client.setID(slaveId);
+                        // Try to identify device
+                        const identification = await identifyDevice(client);
+                        // If device found, add to results
+                        if (identification.present) {
+                            const device = {
+                                ...combination,
+                                identification,
+                            };
+                            discovered.push(device);
+                            onTestAttempt?.(combination, 'found');
+                            onDeviceFound?.(device);
+                            // Apply delay for bus recovery before next test
+                            const reachedLimit = maxDevices > 0 && discovered.length >= maxDevices;
+                            await applyInterTestDelay(delayMs, timeout, true, !reachedLimit);
+                        }
+                        else {
+                            onTestAttempt?.(combination, 'not-found');
+                            // Apply delay before next test (timeout already consumed time)
+                            await applyInterTestDelay(delayMs, timeout, false, true);
+                        }
+                    }
+                    catch {
+                        // Device identification error - skip this slave ID
+                        onTestAttempt?.(combination, 'not-found');
+                        // Apply delay before next test (error/timeout already consumed time)
+                        await applyInterTestDelay(delayMs, timeout, false, true);
+                    }
+                    // Update progress
+                    currentIndex++;
+                    onProgress?.(currentIndex, total, discovered.length);
+                }
+            }
+            finally {
+                // Close connection after testing all slave IDs
+                // Client is always defined here since we only reach this point after successful connection
+                const clientToClose = client;
+                await new Promise((resolve) => clientToClose.close(resolve));
+            }
+        }
+        catch (error) {
+            // Connection error for this serial parameter set - skip entire group
+            // This can happen if port is busy, doesn't exist, or serial params are invalid
+            // Log connection error in verbose mode to help debug hardware issues
+            if (verbose) {
+                const errorMessage = error instanceof Error ? error.message : String(error);
+                console.warn(`Connection failed on ${port} for ${baudRate}/${parity}/${dataBits}/${stopBits}: ${errorMessage}`);
+            }
+            // Still update progress for skipped combinations
+            currentIndex += groupCombinations.length;
+            onProgress?.(currentIndex, total, discovered.length);
+        }
+    }
+    return discovered;
+}
+//# sourceMappingURL=scanner.js.map

package/dist/src/discovery/scanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scanner.js","sourceRoot":"","sources":["../../../src/discovery/scanner.ts"],"names":[],"mappings":"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"}

package/dist/src/formatters/discovery-results.d.ts

@@ -0,0 +1,10 @@
+import type { DiscoveredDevice } from '../discovery/scanner.js';
+/**
+ * Format discovered devices as a table
+ */
+export declare function formatDiscoveryTable(devices: DiscoveredDevice[]): string;
+/**
+ * Format discovered devices as JSON
+ */
+export declare function formatDiscoveryJSON(devices: DiscoveredDevice[]): string;
+//# sourceMappingURL=discovery-results.d.ts.map

package/dist/src/formatters/discovery-results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-results.d.ts","sourceRoot":"","sources":["../../../src/formatters/discovery-results.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAE/D;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAqCxE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAkBvE"}

package/dist/src/formatters/discovery-results.js

@@ -0,0 +1,57 @@
+import Table from 'cli-table3';
+/**
+ * Format discovered devices as a table
+ */
+export function formatDiscoveryTable(devices) {
+    if (devices.length === 0) {
+        return 'No devices found.';
+    }
+    const table = new Table({
+        head: ['Slave ID', 'Baud Rate', 'Parity', 'Data/Stop', 'Response', 'Vendor', 'Model'],
+        style: {
+            head: ['cyan'],
+        },
+    });
+    // Sort by slave ID
+    const sorted = [...devices].sort((a, b) => a.slaveId - b.slaveId);
+    for (const device of sorted) {
+        const { slaveId, baudRate, parity, dataBits, stopBits, identification } = device;
+        const parityChar = parity === 'none' ? 'N' : parity === 'even' ? 'E' : 'O';
+        const dataStop = `${dataBits}${parityChar}${stopBits}`;
+        const vendor = identification.vendorName ?? '-';
+        const model = identification.modelName ?? identification.productCode ?? '-';
+        const responseTime = `${Math.round(identification.responseTimeMs)}ms`;
+        table.push([
+            slaveId.toString(),
+            baudRate.toString(),
+            parityChar,
+            dataStop,
+            responseTime,
+            vendor,
+            model,
+        ]);
+    }
+    return table.toString();
+}
+/**
+ * Format discovered devices as JSON
+ */
+export function formatDiscoveryJSON(devices) {
+    const formatted = devices.map((device) => ({
+        slaveId: device.slaveId,
+        baudRate: device.baudRate,
+        parity: device.parity,
+        dataBits: device.dataBits,
+        stopBits: device.stopBits,
+        responseTimeMs: device.identification.responseTimeMs,
+        identification: {
+            vendorName: device.identification.vendorName,
+            productCode: device.identification.productCode,
+            modelName: device.identification.modelName,
+            revision: device.identification.revision,
+            supportsFC43: device.identification.supportsFC43,
+        },
+    }));
+    return JSON.stringify(formatted, null, 2);
+}
+//# sourceMappingURL=discovery-results.js.map

package/dist/src/formatters/discovery-results.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery-results.js","sourceRoot":"","sources":["../../../src/formatters/discovery-results.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAA;AAI9B;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA2B;IAC9D,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,mBAAmB,CAAA;IAC5B,CAAC;IAED,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC;QACtB,IAAI,EAAE,CAAC,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,CAAC;QACrF,KAAK,EAAE;YACL,IAAI,EAAE,CAAC,MAAM,CAAC;SACf;KACF,CAAC,CAAA;IAEF,mBAAmB;IACnB,MAAM,MAAM,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,OAAO,CAAC,CAAA;IAEjE,KAAK,MAAM,MAAM,IAAI,MAAM,EAAE,CAAC;QAC5B,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,GAAG,MAAM,CAAA;QAEhF,MAAM,UAAU,GAAG,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAA;QAC1E,MAAM,QAAQ,GAAG,GAAG,QAAQ,GAAG,UAAU,GAAG,QAAQ,EAAE,CAAA;QAEtD,MAAM,MAAM,GAAG,cAAc,CAAC,UAAU,IAAI,GAAG,CAAA;QAC/C,MAAM,KAAK,GAAG,cAAc,CAAC,SAAS,IAAI,cAAc,CAAC,WAAW,IAAI,GAAG,CAAA;QAC3E,MAAM,YAAY,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,cAAc,CAAC,IAAI,CAAA;QAErE,KAAK,CAAC,IAAI,CAAC;YACT,OAAO,CAAC,QAAQ,EAAE;YAClB,QAAQ,CAAC,QAAQ,EAAE;YACnB,UAAU;YACV,QAAQ;YACR,YAAY;YACZ,MAAM;YACN,KAAK;SACN,CAAC,CAAA;IACJ,CAAC;IAED,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAA;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,OAA2B;IAC7D,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACzC,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,cAAc,EAAE,MAAM,CAAC,cAAc,CAAC,cAAc;QACpD,cAAc,EAAE;YACd,UAAU,EAAE,MAAM,CAAC,cAAc,CAAC,UAAU;YAC5C,WAAW,EAAE,MAAM,CAAC,cAAc,CAAC,WAAW;YAC9C,SAAS,EAAE,MAAM,CAAC,cAAc,CAAC,SAAS;YAC1C,QAAQ,EAAE,MAAM,CAAC,cAAc,CAAC,QAAQ;YACxC,YAAY,EAAE,MAAM,CAAC,cAAc,CAAC,YAAY;SACjD;KACF,CAAC,CAAC,CAAA;IAEH,OAAO,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;AAC3C,CAAC"}

package/dist/src/formatters/json.d.ts

@@ -0,0 +1,30 @@
+import type { DataPoint } from '@ya-modbus/driver-types';
+/**
+ * Metadata for JSON output
+ */
+export interface JSONMetadata {
+    /** Driver package name */
+    driver?: string | undefined;
+    /** Connection details */
+    connection?: {
+        port?: string | undefined;
+        host?: string | undefined;
+        slaveId?: number | undefined;
+    } | undefined;
+    /** Performance metrics */
+    performance?: {
+        responseTimeMs: number;
+        operations: number;
+        errors: number;
+    } | undefined;
+}
+/**
+ * Format data point results as JSON
+ *
+ * @param dataPoints - Data point definitions
+ * @param values - Data point values (keyed by ID)
+ * @param metadata - Additional metadata to include
+ * @returns Formatted JSON string with 2-space indentation
+ */
+export declare function formatJSON(dataPoints: ReadonlyArray<DataPoint>, values: Record<string, unknown>, metadata: JSONMetadata): string;
+//# sourceMappingURL=json.d.ts.map

package/dist/src/formatters/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../src/formatters/json.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAExD;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,0BAA0B;IAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAC3B,yBAAyB;IACzB,UAAU,CAAC,EACP;QACE,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACzB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;QACzB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAC7B,GACD,SAAS,CAAA;IACb,0BAA0B;IAC1B,WAAW,CAAC,EACR;QACE,cAAc,EAAE,MAAM,CAAA;QACtB,UAAU,EAAE,MAAM,CAAA;QAClB,MAAM,EAAE,MAAM,CAAA;KACf,GACD,SAAS,CAAA;CACd;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CACxB,UAAU,EAAE,aAAa,CAAC,SAAS,CAAC,EACpC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,QAAQ,EAAE,YAAY,GACrB,MAAM,CAyBR"}

package/dist/src/formatters/json.js

@@ -0,0 +1,33 @@
+/**
+ * Format data point results as JSON
+ *
+ * @param dataPoints - Data point definitions
+ * @param values - Data point values (keyed by ID)
+ * @param metadata - Additional metadata to include
+ * @returns Formatted JSON string with 2-space indentation
+ */
+export function formatJSON(dataPoints, values, metadata) {
+    // Build data points array with values
+    const dataPointsWithValues = dataPoints
+        .filter((dp) => dp.id in values)
+        .map((dp) => ({
+        id: dp.id,
+        name: dp.name,
+        value: values[dp.id],
+        type: dp.type,
+        unit: dp.unit,
+        access: dp.access,
+        pollType: dp.pollType,
+    }));
+    // Build output object
+    const output = {
+        timestamp: new Date().toISOString(),
+        ...(metadata.driver && { driver: metadata.driver }),
+        ...(metadata.connection && { connection: metadata.connection }),
+        dataPoints: dataPointsWithValues,
+        ...(metadata.performance && { performance: metadata.performance }),
+    };
+    // Return pretty-printed JSON with 2-space indentation
+    return JSON.stringify(output, null, 2);
+}
+//# sourceMappingURL=json.js.map

package/dist/src/formatters/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../../src/formatters/json.ts"],"names":[],"mappings":"AA0BA;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CACxB,UAAoC,EACpC,MAA+B,EAC/B,QAAsB;IAEtB,sCAAsC;IACtC,MAAM,oBAAoB,GAAG,UAAU;SACpC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,MAAM,CAAC;SAC/B,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;QACZ,EAAE,EAAE,EAAE,CAAC,EAAE;QACT,IAAI,EAAE,EAAE,CAAC,IAAI;QACb,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC;QACpB,IAAI,EAAE,EAAE,CAAC,IAAI;QACb,IAAI,EAAE,EAAE,CAAC,IAAI;QACb,MAAM,EAAE,EAAE,CAAC,MAAM;QACjB,QAAQ,EAAE,EAAE,CAAC,QAAQ;KACtB,CAAC,CAAC,CAAA;IAEL,sBAAsB;IACtB,MAAM,MAAM,GAAG;QACb,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,GAAG,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;QACnD,GAAG,CAAC,QAAQ,CAAC,UAAU,IAAI,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC;QAC/D,UAAU,EAAE,oBAAoB;QAChC,GAAG,CAAC,QAAQ,CAAC,WAAW,IAAI,EAAE,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,CAAC;KACnE,CAAA;IAED,sDAAsD;IACtD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;AACxC,CAAC"}