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

package/README.md

@@ -0,0 +1,69 @@
+# @ya-modbus/device-profiler
+
+Device profiler for discovering Modbus register maps through automated scanning.
+
+## Features
+
+- Scans holding registers (FC03) and input registers (FC04)
+- Batch reading with automatic fallback on errors
+- Real-time progress display
+- Timing measurement for each read operation
+- Error classification (timeout, CRC, Modbus exceptions)
+- Summary table of discovered registers
+
+## Installation
+
+```bash
+npm install @ya-modbus/device-profiler
+```
+
+## Usage
+
+### CLI
+
+```bash
+ya-modbus-profile --port /dev/ttyUSB0 --slave-id 1 --baud 9600
+```
+
+Options:
+
+- `--port` - Serial port or TCP host:port
+- `--slave-id` - Modbus slave ID
+- `--baud` - Baud rate for RTU (default: 9600)
+- `--start` - Start register address (default: 0)
+- `--end` - End register address (default: 100)
+- `--batch` - Batch size for reads (default: 10)
+
+### Programmatic
+
+```typescript
+import { scanRegisters, RegisterType } from '@ya-modbus/device-profiler'
+
+await scanRegisters({
+  transport,
+  type: RegisterType.Holding,
+  startAddress: 0,
+  endAddress: 100,
+  batchSize: 10,
+  onProgress: (current, total) => {
+    console.log(`${current}/${total}`)
+  },
+  onResult: (result) => {
+    console.log(result)
+  },
+})
+```
+
+## Output
+
+The scanner produces a summary showing:
+
+- Register address
+- Register type (holding/input)
+- Read success/failure
+- Response time
+- Error details (if any)
+
+## License
+
+GPL-3.0-or-later

package/dist/bin/profile.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point
+ *
+ * This file is the executable entry point that parses command-line arguments.
+ * The actual CLI implementation is in src/program.ts
+ */
+export {};
+//# sourceMappingURL=profile.d.ts.map

package/dist/bin/profile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.d.ts","sourceRoot":"","sources":["../../bin/profile.ts"],"names":[],"mappings":";AAEA;;;;;GAKG"}

package/dist/bin/profile.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point
+ *
+ * This file is the executable entry point that parses command-line arguments.
+ * The actual CLI implementation is in src/program.ts
+ */
+import { program } from '../src/program.js';
+program.parse();
+//# sourceMappingURL=profile.js.map

package/dist/bin/profile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile.js","sourceRoot":"","sources":["../../bin/profile.ts"],"names":[],"mappings":";AAEA;;;;;GAKG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAE3C,OAAO,CAAC,KAAK,EAAE,CAAA"}

package/dist/src/cli.d.ts

@@ -0,0 +1,27 @@
+/**
+ * CLI orchestrator for register scanning
+ */
+import type { Transport } from '@ya-modbus/driver-types';
+import { RegisterType } from './read-tester.js';
+/**
+ * Options for running a profile scan
+ */
+export interface ProfileScanOptions {
+    /** Modbus transport */
+    transport: Transport;
+    /** Register type to scan */
+    type: RegisterType;
+    /** Starting register address */
+    startAddress: number;
+    /** Ending register address (inclusive) */
+    endAddress: number;
+    /** Maximum registers to read in a single batch (default: 10) */
+    batchSize?: number;
+}
+/**
+ * Run a register profile scan with console output
+ *
+ * @param options - Scan configuration
+ */
+export declare function runProfileScan(options: ProfileScanOptions): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/src/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAIxD,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAA;AAG/C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uBAAuB;IACvB,SAAS,EAAE,SAAS,CAAA;IACpB,4BAA4B;IAC5B,IAAI,EAAE,YAAY,CAAA;IAClB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAA;IACpB,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAA;IAClB,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkC/E"}

package/dist/src/cli.js

@@ -0,0 +1,45 @@
+/**
+ * CLI orchestrator for register scanning
+ */
+import { formatProgress, formatSummary } from './console-formatter.js';
+import { PROGRESS_UPDATE_INTERVAL_MS } from './constants.js';
+import { scanRegisters } from './register-scanner.js';
+/**
+ * Run a register profile scan with console output
+ *
+ * @param options - Scan configuration
+ */
+export async function runProfileScan(options) {
+    const { transport, type, startAddress, endAddress, batchSize } = options;
+    const results = [];
+    try {
+        console.log(`Scanning ${type} registers from ${startAddress} to ${endAddress}...`);
+        console.log();
+        let lastProgressUpdate = 0;
+        await scanRegisters({
+            transport,
+            type,
+            startAddress,
+            endAddress,
+            ...(batchSize !== undefined && { batchSize }),
+            onProgress: (current, total) => {
+                const now = Date.now();
+                if (now - lastProgressUpdate >= PROGRESS_UPDATE_INTERVAL_MS || current === total) {
+                    process.stdout.write(`\r${formatProgress(current, total)}`);
+                    lastProgressUpdate = now;
+                }
+            },
+            onResult: (result) => {
+                results.push(result);
+            },
+        });
+        console.log('\n');
+        console.log('Scan complete!');
+        console.log();
+        console.log(formatSummary(results));
+    }
+    finally {
+        await transport.close();
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/src/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../../src/cli.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACtE,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAA;AAE5D,OAAO,EAAE,aAAa,EAAmB,MAAM,uBAAuB,CAAA;AAkBtE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAA2B;IAC9D,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,OAAO,CAAA;IACxE,MAAM,OAAO,GAAiB,EAAE,CAAA;IAEhC,IAAI,CAAC;QACH,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,mBAAmB,YAAY,OAAO,UAAU,KAAK,CAAC,CAAA;QAClF,OAAO,CAAC,GAAG,EAAE,CAAA;QAEb,IAAI,kBAAkB,GAAG,CAAC,CAAA;QAC1B,MAAM,aAAa,CAAC;YAClB,SAAS;YACT,IAAI;YACJ,YAAY;YACZ,UAAU;YACV,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,CAAC;YAC7C,UAAU,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE;gBAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAA;gBACtB,IAAI,GAAG,GAAG,kBAAkB,IAAI,2BAA2B,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;oBACjF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,cAAc,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,CAAA;oBAC3D,kBAAkB,GAAG,GAAG,CAAA;gBAC1B,CAAC;YACH,CAAC;YACD,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;gBACnB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;YACtB,CAAC;SACF,CAAC,CAAA;QAEF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACjB,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAA;QAC7B,OAAO,CAAC,GAAG,EAAE,CAAA;QACb,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAA;IACrC,CAAC;YAAS,CAAC;QACT,MAAM,SAAS,CAAC,KAAK,EAAE,CAAA;IACzB,CAAC;AACH,CAAC"}

package/dist/src/console-formatter.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Console output formatting for register scanning
+ */
+import type { ScanResult } from './register-scanner.js';
+/**
+ * Format progress message
+ *
+ * @param current - Current count
+ * @param total - Total count
+ * @returns Formatted progress string
+ */
+export declare function formatProgress(current: number, total: number): string;
+/**
+ * Format summary table of scan results
+ *
+ * @param results - Scan results
+ * @returns Formatted table string
+ */
+export declare function formatSummary(results: ScanResult[]): string;
+//# sourceMappingURL=console-formatter.d.ts.map

package/dist/src/console-formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-formatter.d.ts","sourceRoot":"","sources":["../../src/console-formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAEvD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrE;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CAiB3D"}

package/dist/src/console-formatter.js

@@ -0,0 +1,36 @@
+/**
+ * Console output formatting for register scanning
+ */
+import Table from 'cli-table3';
+/**
+ * Format progress message
+ *
+ * @param current - Current count
+ * @param total - Total count
+ * @returns Formatted progress string
+ */
+export function formatProgress(current, total) {
+    const percentage = total > 0 ? Math.round((current / total) * 100) : 0;
+    return `Progress: ${current}/${total} (${percentage}%)`;
+}
+/**
+ * Format summary table of scan results
+ *
+ * @param results - Scan results
+ * @returns Formatted table string
+ */
+export function formatSummary(results) {
+    const table = new Table({
+        head: ['Address', 'Type', 'Status', 'Value', 'Timing (ms)', 'Error'],
+        style: { head: [] },
+    });
+    for (const result of results) {
+        const value = result.success && result.value ? result.value.toString('hex').toUpperCase() : '-';
+        const status = result.success ? 'OK' : 'FAIL';
+        const error = result.error ?? '-';
+        const timing = result.timing.toFixed(1);
+        table.push([result.address.toString(), result.type, status, value, timing, error]);
+    }
+    return table.toString();
+}
+//# sourceMappingURL=console-formatter.js.map

package/dist/src/console-formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-formatter.js","sourceRoot":"","sources":["../../src/console-formatter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,MAAM,YAAY,CAAA;AAI9B;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,KAAa;IAC3D,MAAM,UAAU,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,OAAO,GAAG,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;IACtE,OAAO,aAAa,OAAO,IAAI,KAAK,KAAK,UAAU,IAAI,CAAA;AACzD,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,OAAqB;IACjD,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC;QACtB,IAAI,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,CAAC;QACpE,KAAK,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;KACpB,CAAC,CAAA;IAEF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,GAAG,CAAA;QAE/F,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAA;QAC7C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,GAAG,CAAA;QACjC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAA;QAEvC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAA;IACpF,CAAC;IAED,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAA;AACzB,CAAC"}

package/dist/src/constants.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Constants for Modbus device profiling
+ */
+/** Minimum valid TCP port number */
+export declare const MIN_PORT = 1;
+/** Maximum valid TCP port number */
+export declare const MAX_PORT = 65535;
+/** Minimum valid Modbus slave ID */
+export declare const MIN_SLAVE_ID = 1;
+/** Maximum valid Modbus slave ID */
+export declare const MAX_SLAVE_ID = 247;
+/** Default batch size for register reads */
+export declare const DEFAULT_BATCH_SIZE = 10;
+/** Number of bytes per Modbus register */
+export declare const BYTES_PER_REGISTER = 2;
+/** Minimum interval between progress updates in milliseconds */
+export declare const PROGRESS_UPDATE_INTERVAL_MS = 100;
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oCAAoC;AACpC,eAAO,MAAM,QAAQ,IAAI,CAAA;AAEzB,oCAAoC;AACpC,eAAO,MAAM,QAAQ,QAAQ,CAAA;AAE7B,oCAAoC;AACpC,eAAO,MAAM,YAAY,IAAI,CAAA;AAE7B,oCAAoC;AACpC,eAAO,MAAM,YAAY,MAAM,CAAA;AAE/B,4CAA4C;AAC5C,eAAO,MAAM,kBAAkB,KAAK,CAAA;AAEpC,0CAA0C;AAC1C,eAAO,MAAM,kBAAkB,IAAI,CAAA;AAEnC,gEAAgE;AAChE,eAAO,MAAM,2BAA2B,MAAM,CAAA"}

package/dist/src/constants.js

@@ -0,0 +1,18 @@
+/**
+ * Constants for Modbus device profiling
+ */
+/** Minimum valid TCP port number */
+export const MIN_PORT = 1;
+/** Maximum valid TCP port number */
+export const MAX_PORT = 65535;
+/** Minimum valid Modbus slave ID */
+export const MIN_SLAVE_ID = 1;
+/** Maximum valid Modbus slave ID */
+export const MAX_SLAVE_ID = 247;
+/** Default batch size for register reads */
+export const DEFAULT_BATCH_SIZE = 10;
+/** Number of bytes per Modbus register */
+export const BYTES_PER_REGISTER = 2;
+/** Minimum interval between progress updates in milliseconds */
+export const PROGRESS_UPDATE_INTERVAL_MS = 100;
+//# sourceMappingURL=constants.js.map

package/dist/src/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../src/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,oCAAoC;AACpC,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAA;AAEzB,oCAAoC;AACpC,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,CAAA;AAE7B,oCAAoC;AACpC,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAA;AAE7B,oCAAoC;AACpC,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,CAAA;AAE/B,4CAA4C;AAC5C,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAA;AAEpC,0CAA0C;AAC1C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAA;AAEnC,gEAAgE;AAChE,MAAM,CAAC,MAAM,2BAA2B,GAAG,GAAG,CAAA"}

package/dist/src/error-classifier.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Error classification for Modbus operations
+ */
+/**
+ * Modbus error types
+ */
+export declare enum ErrorType {
+    /** Operation timed out */
+    Timeout = "timeout",
+    /** CRC or checksum validation failed */
+    CRC = "crc",
+    /** Modbus exception code returned by device */
+    ModbusException = "modbus_exception",
+    /** Unknown or unclassified error */
+    Unknown = "unknown"
+}
+/**
+ * Classify a Modbus error by examining its message and properties
+ *
+ * @param error - Error to classify
+ * @returns Error classification
+ */
+export declare function classifyError(error: Error): ErrorType;
+//# sourceMappingURL=error-classifier.d.ts.map

package/dist/src/error-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-classifier.d.ts","sourceRoot":"","sources":["../../src/error-classifier.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,oBAAY,SAAS;IACnB,0BAA0B;IAC1B,OAAO,YAAY;IACnB,wCAAwC;IACxC,GAAG,QAAQ;IACX,+CAA+C;IAC/C,eAAe,qBAAqB;IACpC,oCAAoC;IACpC,OAAO,YAAY;CACpB;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAwBrD"}

package/dist/src/error-classifier.js

@@ -0,0 +1,43 @@
+/**
+ * Error classification for Modbus operations
+ */
+/**
+ * Modbus error types
+ */
+export var ErrorType;
+(function (ErrorType) {
+    /** Operation timed out */
+    ErrorType["Timeout"] = "timeout";
+    /** CRC or checksum validation failed */
+    ErrorType["CRC"] = "crc";
+    /** Modbus exception code returned by device */
+    ErrorType["ModbusException"] = "modbus_exception";
+    /** Unknown or unclassified error */
+    ErrorType["Unknown"] = "unknown";
+})(ErrorType || (ErrorType = {}));
+/**
+ * Classify a Modbus error by examining its message and properties
+ *
+ * @param error - Error to classify
+ * @returns Error classification
+ */
+export function classifyError(error) {
+    const message = error.message?.toLowerCase() ?? '';
+    const code = error.code;
+    // Check for timeout
+    if (message.includes('timeout') || message.includes('timed out') || code === 'ETIMEDOUT') {
+        return ErrorType.Timeout;
+    }
+    // Check for CRC/checksum errors
+    if (message.includes('crc') || message.includes('checksum')) {
+        return ErrorType.CRC;
+    }
+    // Check for Modbus exceptions
+    if (/modbus\s+exception/i.test(message) ||
+        /exception\s+code\s+0x[0-9a-f]+/i.test(message) ||
+        /exception\s+\d+/.test(message)) {
+        return ErrorType.ModbusException;
+    }
+    return ErrorType.Unknown;
+}
+//# sourceMappingURL=error-classifier.js.map

package/dist/src/error-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-classifier.js","sourceRoot":"","sources":["../../src/error-classifier.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,CAAN,IAAY,SASX;AATD,WAAY,SAAS;IACnB,0BAA0B;IAC1B,gCAAmB,CAAA;IACnB,wCAAwC;IACxC,wBAAW,CAAA;IACX,+CAA+C;IAC/C,iDAAoC,CAAA;IACpC,oCAAoC;IACpC,gCAAmB,CAAA;AACrB,CAAC,EATW,SAAS,KAAT,SAAS,QASpB;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,KAAY;IACxC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,CAAA;IAClD,MAAM,IAAI,GAAI,KAA+B,CAAC,IAAI,CAAA;IAElD,oBAAoB;IACpB,IAAI,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;QACzF,OAAO,SAAS,CAAC,OAAO,CAAA;IAC1B,CAAC;IAED,gCAAgC;IAChC,IAAI,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QAC5D,OAAO,SAAS,CAAC,GAAG,CAAA;IACtB,CAAC;IAED,8BAA8B;IAC9B,IACE,qBAAqB,CAAC,IAAI,CAAC,OAAO,CAAC;QACnC,iCAAiC,CAAC,IAAI,CAAC,OAAO,CAAC;QAC/C,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,EAC/B,CAAC;QACD,OAAO,SAAS,CAAC,eAAe,CAAA;IAClC,CAAC;IAED,OAAO,SAAS,CAAC,OAAO,CAAA;AAC1B,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @ya-modbus/device-profiler - Device profiler for discovering Modbus register maps
+ */
+export { classifyError, ErrorType } from './error-classifier.js';
+export { formatProgress, formatSummary } from './console-formatter.js';
+export { testRead, RegisterType, type ReadTestResult } from './read-tester.js';
+export { scanRegisters, type ScanOptions, type ScanResult } from './register-scanner.js';
+export { BYTES_PER_REGISTER, DEFAULT_BATCH_SIZE, MAX_PORT, MAX_SLAVE_ID, MIN_PORT, MIN_SLAVE_ID, PROGRESS_UPDATE_INTERVAL_MS, } from './constants.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAChE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACtE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAC9E,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,uBAAuB,CAAA;AACxF,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,2BAA2B,GAC5B,MAAM,gBAAgB,CAAA"}

package/dist/src/index.js

@@ -0,0 +1,9 @@
+/**
+ * @ya-modbus/device-profiler - Device profiler for discovering Modbus register maps
+ */
+export { classifyError, ErrorType } from './error-classifier.js';
+export { formatProgress, formatSummary } from './console-formatter.js';
+export { testRead, RegisterType } from './read-tester.js';
+export { scanRegisters } from './register-scanner.js';
+export { BYTES_PER_REGISTER, DEFAULT_BATCH_SIZE, MAX_PORT, MAX_SLAVE_ID, MIN_PORT, MIN_SLAVE_ID, PROGRESS_UPDATE_INTERVAL_MS, } from './constants.js';
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAChE,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACtE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAuB,MAAM,kBAAkB,CAAA;AAC9E,OAAO,EAAE,aAAa,EAAqC,MAAM,uBAAuB,CAAA;AACxF,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,YAAY,EACZ,2BAA2B,GAC5B,MAAM,gBAAgB,CAAA"}

package/dist/src/program.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * CLI program for device profiler
+ */
+import { Command } from 'commander';
+export declare const program: Command;
+//# sourceMappingURL=program.d.ts.map

package/dist/src/program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"program.d.ts","sourceRoot":"","sources":["../../src/program.ts"],"names":[],"mappings":";AAEA;;GAEG;AAIH,OAAO,EAAE,OAAO,EAAU,MAAM,WAAW,CAAA;AAsB3C,eAAO,MAAM,OAAO,SAAgB,CAAA"}

package/dist/src/program.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+/**
+ * CLI program for device profiler
+ */
+import { createTransport } from '@ya-modbus/transport';
+import { Command, Option } from 'commander';
+import { runProfileScan } from './cli.js';
+import { MAX_PORT, MIN_PORT } from './constants.js';
+import { RegisterType } from './read-tester.js';
+const parseNumber = (value) => parseInt(value, 10);
+export const program = new Command();
+program
+    .name('ya-modbus-profile')
+    .description('Profile Modbus devices by scanning register ranges')
+    .version('0.1.0')
+    .requiredOption('--port <port>', 'Serial port (e.g., /dev/ttyUSB0) or TCP host:port')
+    .requiredOption('--slave-id <id>', 'Modbus slave ID (1-247)', parseNumber)
+    .option('--type <type>', 'Register type: holding or input', 'holding')
+    .option('--start <address>', 'Start register address', parseNumber, 0)
+    .option('--end <address>', 'End register address', parseNumber, 100)
+    .option('--batch <size>', 'Batch size for reads', parseNumber, 10)
+    .option('--baud <rate>', 'Baud rate for RTU', parseNumber, 9600)
+    .addOption(new Option('--parity <parity>', 'Parity for RTU')
+    .choices(['none', 'even', 'odd'])
+    .default('none'))
+    .option('--data-bits <bits>', 'Data bits for RTU', parseNumber, 8)
+    .option('--stop-bits <bits>', 'Stop bits for RTU', parseNumber, 1)
+    .option('--timeout <ms>', 'Response timeout in milliseconds', parseNumber, 1000)
+    .action(async (options) => {
+    try {
+        const registerType = options.type === 'input' ? RegisterType.Input : RegisterType.Holding;
+        let transport;
+        if (options.port.includes(':')) {
+            const parts = options.port.split(':');
+            const host = parts[0];
+            const portStr = parts[1];
+            if (!host || !portStr) {
+                throw new Error('Invalid TCP address format. Expected host:port');
+            }
+            const port = parseInt(portStr, 10);
+            if (isNaN(port) || port < MIN_PORT || port > MAX_PORT) {
+                throw new Error(`Invalid port number: ${portStr}. Must be between ${MIN_PORT} and ${MAX_PORT}`);
+            }
+            transport = await createTransport({
+                host,
+                port,
+                slaveId: options.slaveId,
+                timeout: options.timeout,
+            });
+        }
+        else {
+            transport = await createTransport({
+                port: options.port,
+                baudRate: options.baud,
+                dataBits: options.dataBits,
+                parity: options.parity,
+                stopBits: options.stopBits,
+                slaveId: options.slaveId,
+                timeout: options.timeout,
+            });
+        }
+        await runProfileScan({
+            transport,
+            type: registerType,
+            startAddress: options.start,
+            endAddress: options.end,
+            batchSize: options.batch,
+        });
+    }
+    catch (error) {
+        console.error('Error:', error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+});
+//# sourceMappingURL=program.js.map

package/dist/src/program.js.map

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

package/dist/src/read-tester.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Read testing utilities for Modbus registers
+ */
+import type { Transport } from '@ya-modbus/driver-types';
+import { ErrorType } from './error-classifier.js';
+/**
+ * Modbus register type
+ */
+export declare enum RegisterType {
+    /** Holding registers (FC03) */
+    Holding = "holding",
+    /** Input registers (FC04) */
+    Input = "input"
+}
+/**
+ * Result of a register read test
+ */
+export interface ReadTestResult {
+    /** Whether the read was successful */
+    success: boolean;
+    /** Register data if successful */
+    data?: Buffer;
+    /** Time taken for the read operation in milliseconds */
+    timing: number;
+    /** Error message if failed */
+    error?: string;
+    /** Classified error type if failed */
+    errorType?: ErrorType;
+}
+/**
+ * Test reading a register with timing measurement
+ *
+ * @param transport - Modbus transport
+ * @param type - Register type (holding or input)
+ * @param address - Starting register address
+ * @param count - Number of registers to read
+ * @returns Read test result with timing information
+ */
+export declare function testRead(transport: Transport, type: RegisterType, address: number, count: number): Promise<ReadTestResult>;
+//# sourceMappingURL=read-tester.d.ts.map

package/dist/src/read-tester.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-tester.d.ts","sourceRoot":"","sources":["../../src/read-tester.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAExD,OAAO,EAAiB,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAEhE;;GAEG;AACH,oBAAY,YAAY;IACtB,+BAA+B;IAC/B,OAAO,YAAY;IACnB,6BAA6B;IAC7B,KAAK,UAAU;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAA;IAChB,kCAAkC;IAClC,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAA;IACd,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,sCAAsC;IACtC,SAAS,CAAC,EAAE,SAAS,CAAA;CACtB;AAED;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAC5B,SAAS,EAAE,SAAS,EACpB,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,cAAc,CAAC,CA6BzB"}

package/dist/src/read-tester.js

@@ -0,0 +1,52 @@
+/**
+ * Read testing utilities for Modbus registers
+ */
+import { classifyError } from './error-classifier.js';
+/**
+ * Modbus register type
+ */
+export var RegisterType;
+(function (RegisterType) {
+    /** Holding registers (FC03) */
+    RegisterType["Holding"] = "holding";
+    /** Input registers (FC04) */
+    RegisterType["Input"] = "input";
+})(RegisterType || (RegisterType = {}));
+/**
+ * Test reading a register with timing measurement
+ *
+ * @param transport - Modbus transport
+ * @param type - Register type (holding or input)
+ * @param address - Starting register address
+ * @param count - Number of registers to read
+ * @returns Read test result with timing information
+ */
+export async function testRead(transport, type, address, count) {
+    const startTime = performance.now();
+    try {
+        let data;
+        if (type === RegisterType.Holding) {
+            data = await transport.readHoldingRegisters(address, count);
+        }
+        else {
+            data = await transport.readInputRegisters(address, count);
+        }
+        const timing = performance.now() - startTime;
+        return {
+            success: true,
+            data,
+            timing,
+        };
+    }
+    catch (err) {
+        const timing = performance.now() - startTime;
+        const error = err instanceof Error ? err : new Error(String(err));
+        return {
+            success: false,
+            timing,
+            error: error.message,
+            errorType: classifyError(error),
+        };
+    }
+}
+//# sourceMappingURL=read-tester.js.map

package/dist/src/read-tester.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-tester.js","sourceRoot":"","sources":["../../src/read-tester.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,EAAE,aAAa,EAAa,MAAM,uBAAuB,CAAA;AAEhE;;GAEG;AACH,MAAM,CAAN,IAAY,YAKX;AALD,WAAY,YAAY;IACtB,+BAA+B;IAC/B,mCAAmB,CAAA;IACnB,6BAA6B;IAC7B,+BAAe,CAAA;AACjB,CAAC,EALW,YAAY,KAAZ,YAAY,QAKvB;AAkBD;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,SAAoB,EACpB,IAAkB,EAClB,OAAe,EACf,KAAa;IAEb,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;IAEnC,IAAI,CAAC;QACH,IAAI,IAAY,CAAA;QAChB,IAAI,IAAI,KAAK,YAAY,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,GAAG,MAAM,SAAS,CAAC,oBAAoB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QAC7D,CAAC;aAAM,CAAC;YACN,IAAI,GAAG,MAAM,SAAS,CAAC,kBAAkB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;QAC3D,CAAC;QAED,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;QAE5C,OAAO;YACL,OAAO,EAAE,IAAI;YACb,IAAI;YACJ,MAAM;SACP,CAAA;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,GAAG,SAAS,CAAA;QAC5C,MAAM,KAAK,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;QAEjE,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM;YACN,KAAK,EAAE,KAAK,CAAC,OAAO;YACpB,SAAS,EAAE,aAAa,CAAC,KAAK,CAAC;SAChC,CAAA;IACH,CAAC;AACH,CAAC"}

package/dist/src/register-scanner.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Register scanner with batch reading and automatic fallback
+ */
+import type { Transport } from '@ya-modbus/driver-types';
+import type { ErrorType } from './error-classifier.js';
+import { RegisterType } from './read-tester.js';
+/**
+ * Result of scanning a single register
+ */
+export interface ScanResult {
+    /** Register address */
+    address: number;
+    /** Register type */
+    type: RegisterType;
+    /** Whether the read was successful */
+    success: boolean;
+    /** Register value if successful (2 bytes) */
+    value?: Buffer;
+    /** Time taken for the read operation in milliseconds */
+    timing: number;
+    /** Error message if failed */
+    error?: string;
+    /** Classified error type if failed */
+    errorType?: ErrorType;
+}
+/**
+ * Options for register scanning
+ */
+export interface ScanOptions {
+    /** Modbus transport */
+    transport: Transport;
+    /** Register type to scan */
+    type: RegisterType;
+    /** Starting register address */
+    startAddress: number;
+    /** Ending register address (inclusive) */
+    endAddress: number;
+    /** Maximum registers to read in a single batch (default: 10) */
+    batchSize?: number;
+    /** Callback for progress updates */
+    onProgress?: (current: number, total: number) => void;
+    /** Callback for each register result */
+    onResult?: (result: ScanResult) => void;
+}
+/**
+ * Scan a range of registers with batch reads and automatic fallback
+ *
+ * @param options - Scan configuration
+ */
+export declare function scanRegisters(options: ScanOptions): Promise<void>;
+//# sourceMappingURL=register-scanner.d.ts.map