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

package/dist/src/utils/commands.js

@@ -0,0 +1,400 @@
+import readline from 'readline/promises';
+import { loadDriver } from '@ya-modbus/driver-loader';
+import { createTransport } from '@ya-modbus/transport';
+import { omitUndefined } from './object-utils.js';
+import { validateSerialOptions } from './validation.js';
+/**
+ * Default RTU transport configuration values
+ */
+export const DEFAULT_RTU_CONFIG = {
+    port: '/dev/ttyUSB0',
+    baudRate: 9600,
+    dataBits: 8,
+    parity: 'even',
+    stopBits: 1,
+};
+/**
+ * Default TCP port for Modbus TCP
+ */
+export const DEFAULT_TCP_PORT = 502;
+/**
+ * Check if a data point is readable
+ */
+export function isReadable(dataPoint) {
+    const access = dataPoint.access ?? 'r';
+    return access === 'r' || access === 'rw';
+}
+/**
+ * Check if a data point is writable
+ */
+export function isWritable(dataPoint) {
+    const access = dataPoint.access ?? 'r';
+    return access === 'w' || access === 'rw';
+}
+/**
+ * Find a data point by ID
+ *
+ * @param driver - Device driver instance
+ * @param id - Data point ID
+ * @returns Data point definition
+ * @throws Error if data point not found
+ */
+export function findDataPoint(driver, id) {
+    const dataPoint = driver.dataPoints.find((dp) => dp.id === id);
+    if (!dataPoint) {
+        throw new Error(`Data point not found: ${id}`);
+    }
+    return dataPoint;
+}
+/**
+ * Find and validate a readable data point
+ *
+ * @param driver - Device driver instance
+ * @param id - Data point ID
+ * @returns Data point definition
+ * @throws Error if data point not found or not readable
+ */
+export function findReadableDataPoint(driver, id) {
+    const dataPoint = findDataPoint(driver, id);
+    if (!isReadable(dataPoint)) {
+        throw new Error(`Data point is write-only: ${id}`);
+    }
+    return dataPoint;
+}
+/**
+ * Find and validate a writable data point
+ *
+ * @param driver - Device driver instance
+ * @param id - Data point ID
+ * @returns Data point definition
+ * @throws Error if data point not found or not writable
+ */
+export function findWritableDataPoint(driver, id) {
+    const dataPoint = findDataPoint(driver, id);
+    if (!isWritable(dataPoint)) {
+        throw new Error(`Data point is read-only: ${id}`);
+    }
+    return dataPoint;
+}
+/**
+ * Compare two floating point numbers for approximate equality
+ *
+ * Uses relative error to handle both very small and very large values correctly.
+ * Also checks absolute error to handle values near zero.
+ *
+ * @param a - First value
+ * @param b - Second value
+ * @param relativeEpsilon - Relative error tolerance (default: 1e-6, or 0.0001%)
+ * @param absoluteEpsilon - Absolute error tolerance for values near zero (default: 1e-9)
+ * @returns True if values are approximately equal
+ */
+export function floatsEqual(a, b, relativeEpsilon = 1e-6, absoluteEpsilon = 1e-9) {
+    const absoluteError = Math.abs(a - b);
+    // Check absolute error first (handles values near zero)
+    if (absoluteError < absoluteEpsilon) {
+        return true;
+    }
+    // Check relative error (handles large and small values)
+    const largestMagnitude = Math.max(Math.abs(a), Math.abs(b));
+    const relativeError = absoluteError / largestMagnitude;
+    return relativeError < relativeEpsilon;
+}
+/**
+ * Parse value string based on data point type
+ */
+export function parseValue(valueStr, dataPoint) {
+    switch (dataPoint.type) {
+        case 'float':
+            return parseFloat(valueStr);
+        case 'integer':
+            return parseInt(valueStr, 10);
+        case 'boolean':
+            return valueStr.toLowerCase() === 'true' || valueStr === '1';
+        case 'string':
+            return valueStr;
+        case 'enum': {
+            // Try to parse as number first, otherwise use string
+            const num = parseInt(valueStr, 10);
+            return isNaN(num) ? valueStr : num;
+        }
+        default:
+            return valueStr;
+    }
+}
+/**
+ * Validate value against data point constraints
+ */
+export function validateValue(value, dataPoint) {
+    // Check min/max for numeric types
+    if ((dataPoint.type === 'float' || dataPoint.type === 'integer') && typeof value === 'number') {
+        if (dataPoint.min !== undefined && value < dataPoint.min) {
+            throw new Error(`Value ${value} is outside valid range [${dataPoint.min}, ${dataPoint.max ?? '∞'}]`);
+        }
+        if (dataPoint.max !== undefined && value > dataPoint.max) {
+            throw new Error(`Value ${value} is outside valid range [${dataPoint.min ?? '-∞'}, ${dataPoint.max}]`);
+        }
+    }
+    // Validate enum values
+    if (dataPoint.type === 'enum' && dataPoint.enumValues) {
+        const validKeys = Object.keys(dataPoint.enumValues);
+        const valueStr = String(value);
+        if (!validKeys.includes(valueStr)) {
+            throw new Error(`Invalid enum value: ${String(value)}. Valid values: ${validKeys.join(', ')}`);
+        }
+    }
+}
+/**
+ * Prompt user for confirmation
+ */
+export async function confirm(message) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    try {
+        const answer = await rl.question(`${message} (y/N): `);
+        return answer.toLowerCase() === 'y';
+    }
+    finally {
+        rl.close();
+    }
+}
+/**
+ * Execute a function with a transport, ensuring cleanup
+ *
+ * @param options - Transport configuration options
+ * @param fn - Function to execute with the transport
+ * @returns Result of the function
+ */
+export async function withTransport(options, fn) {
+    // Build transport configuration
+    const transportConfig = options.host
+        ? {
+            // TCP configuration
+            host: options.host,
+            port: typeof options.port === 'number' ? options.port : DEFAULT_TCP_PORT,
+            slaveId: options.slaveId,
+            timeout: options.timeout,
+        }
+        : {
+            // RTU configuration
+            port: options.port ?? DEFAULT_RTU_CONFIG.port,
+            baudRate: options.baudRate ?? DEFAULT_RTU_CONFIG.baudRate,
+            dataBits: (options.dataBits ?? DEFAULT_RTU_CONFIG.dataBits),
+            parity: (options.parity ?? DEFAULT_RTU_CONFIG.parity),
+            stopBits: (options.stopBits ?? DEFAULT_RTU_CONFIG.stopBits),
+            slaveId: options.slaveId,
+            timeout: options.timeout,
+        };
+    // Create transport
+    const transport = await createTransport(transportConfig);
+    try {
+        return await fn(transport);
+    }
+    finally {
+        // Always close the transport to release resources and allow process to exit
+        await transport.close();
+    }
+}
+/**
+ * Load driver metadata without creating an instance
+ *
+ * When no driver name is provided, auto-detects from current working directory.
+ *
+ * @param driverName - Optional driver package name (auto-detects from cwd if not specified)
+ * @returns Loaded driver metadata
+ */
+export async function loadDriverMetadata(driverName) {
+    return await loadDriver(driverName ? { driverPackage: driverName } : {});
+}
+/**
+ * Get the effective default config for a device
+ *
+ * Returns device-specific config if available, otherwise driver-level config.
+ *
+ * @param driverMetadata - Loaded driver metadata
+ * @param device - Optional device key
+ * @returns Effective default config or undefined
+ */
+export function getEffectiveDefaultConfig(driverMetadata, device) {
+    if (!driverMetadata) {
+        return undefined;
+    }
+    // Check for device-specific config first
+    if (device && driverMetadata.devices?.[device]?.defaultConfig) {
+        const deviceConfig = driverMetadata.devices[device].defaultConfig;
+        if (deviceConfig && 'baudRate' in deviceConfig) {
+            return deviceConfig;
+        }
+    }
+    // Fall back to driver-level config
+    const driverConfig = driverMetadata.defaultConfig;
+    if (driverConfig && 'baudRate' in driverConfig) {
+        return driverConfig;
+    }
+    return undefined;
+}
+/**
+ * Get the effective supported config for a device
+ *
+ * Returns device-specific constraints if available, otherwise driver-level constraints.
+ *
+ * @param driverMetadata - Loaded driver metadata
+ * @param device - Optional device key
+ * @returns Effective supported config or undefined
+ */
+export function getEffectiveSupportedConfig(driverMetadata, device) {
+    if (!driverMetadata) {
+        return undefined;
+    }
+    // Check for device-specific config first
+    if (device && driverMetadata.devices?.[device]?.supportedConfig) {
+        return driverMetadata.devices[device].supportedConfig;
+    }
+    // Fall back to driver-level config
+    return driverMetadata.supportedConfig;
+}
+/**
+ * Create an effective driver metadata with device-specific configs resolved
+ *
+ * This creates a view of the driver metadata where defaultConfig and supportedConfig
+ * are resolved based on the selected device. This allows validation and other
+ * functions to work with device-specific settings transparently.
+ *
+ * @param driverMetadata - Loaded driver metadata
+ * @param device - Optional device key
+ * @returns Driver metadata with effective configs for the selected device
+ */
+export function getEffectiveDriverMetadata(driverMetadata, device) {
+    const effectiveDefaultConfig = getEffectiveDefaultConfig(driverMetadata, device);
+    const effectiveSupportedConfig = getEffectiveSupportedConfig(driverMetadata, device);
+    // Build result conditionally to satisfy exactOptionalPropertyTypes
+    const result = {
+        createDriver: driverMetadata.createDriver,
+    };
+    if (driverMetadata.devices) {
+        result.devices = driverMetadata.devices;
+    }
+    if (effectiveDefaultConfig) {
+        result.defaultConfig = effectiveDefaultConfig;
+    }
+    if (effectiveSupportedConfig) {
+        result.supportedConfig = effectiveSupportedConfig;
+    }
+    return result;
+}
+/**
+ * Apply driver defaults to transport options
+ *
+ * Uses device-specific defaults if a device is selected, otherwise driver-level defaults.
+ *
+ * @param options - Transport options (may be incomplete)
+ * @param driverMetadata - Loaded driver metadata with defaults
+ * @param device - Optional device key for multi-device drivers
+ * @returns Transport options with defaults applied
+ */
+export function applyDriverDefaults(options, driverMetadata, device) {
+    // For TCP connections, no serial defaults apply
+    if (options.host) {
+        return options;
+    }
+    // Get effective config (device-specific or driver-level)
+    const defaultConfig = getEffectiveDefaultConfig(driverMetadata, device);
+    if (!defaultConfig) {
+        return options;
+    }
+    // Apply defaults for unspecified options
+    return {
+        ...options,
+        baudRate: options.baudRate ?? defaultConfig.baudRate,
+        dataBits: options.dataBits ?? defaultConfig.dataBits,
+        stopBits: options.stopBits ?? defaultConfig.stopBits,
+        parity: options.parity ?? defaultConfig.parity,
+        slaveId: options.slaveId ?? defaultConfig.defaultAddress,
+    };
+}
+/**
+ * Execute a function with a driver instance, ensuring cleanup
+ *
+ * @param transport - Transport to use for driver communication
+ * @param driverMetadata - Loaded driver metadata
+ * @param slaveId - Modbus slave ID
+ * @param device - Optional device key for multi-device drivers
+ * @param fn - Function to execute with the driver
+ * @returns Result of the function
+ */
+export async function withDriverInstance(transport, driverMetadata, slaveId, device, fn) {
+    // Validate device key if DEVICES registry exists
+    if (driverMetadata.devices) {
+        const validDevices = Object.keys(driverMetadata.devices);
+        if (device && !validDevices.includes(device)) {
+            throw new Error(`Unknown device: ${device}. Valid devices: ${validDevices.join(', ')}`);
+        }
+    }
+    else if (device) {
+        // Warn user that --device is ignored for single-device drivers
+        console.warn(`Warning: --device '${device}' ignored (driver does not export a DEVICES registry)`);
+    }
+    // Create driver instance - only include device if defined
+    const driverConfig = device ? { transport, slaveId, device } : { transport, slaveId };
+    const driver = await driverMetadata.createDriver(driverConfig);
+    return await fn(driver);
+}
+/**
+ * Execute a function with a driver instance, handling the complete workflow
+ *
+ * This is a convenience function that:
+ * 1. Loads driver metadata (DEFAULT_CONFIG, SUPPORTED_CONFIG)
+ * 2. Validates user options against driver constraints (SUPPORTED_CONFIG)
+ * 3. Applies driver defaults to user options
+ * 4. Validates merged options (catches invalid third-party driver defaults)
+ * 5. Creates transport with merged configuration
+ * 6. Creates driver instance
+ * 7. Executes callback with driver and merged options
+ * 8. Ensures cleanup (closes transport)
+ *
+ * @param options - Combined transport and driver options
+ * @param fn - Function to execute with the driver (and optionally merged config)
+ * @returns Result of the function
+ * @throws ValidationError if user options or driver defaults violate constraints
+ */
+export async function withDriver(options, fn) {
+    // Load driver metadata first
+    const driverMetadata = await loadDriverMetadata(options.driver);
+    // Get effective metadata with device-specific configs resolved
+    const effectiveMetadata = getEffectiveDriverMetadata(driverMetadata, options.device);
+    // Validate user-specified options against device/driver constraints (only for RTU connections)
+    if (!options.host) {
+        const validationOptions = omitUndefined({
+            baudRate: options.baudRate,
+            parity: options.parity,
+            dataBits: options.dataBits,
+            stopBits: options.stopBits,
+            slaveId: options.slaveId,
+        });
+        validateSerialOptions(validationOptions, effectiveMetadata);
+    }
+    // Apply driver defaults to options (device-specific if selected)
+    const mergedOptions = applyDriverDefaults(options, driverMetadata, options.device);
+    // Validate merged options to catch invalid defaults from third-party drivers
+    // This ensures driver DEFAULT_CONFIG values are valid according to SUPPORTED_CONFIG
+    if (!mergedOptions.host) {
+        const mergedValidationOptions = omitUndefined({
+            baudRate: mergedOptions.baudRate,
+            parity: mergedOptions.parity,
+            dataBits: mergedOptions.dataBits,
+            stopBits: mergedOptions.stopBits,
+            slaveId: mergedOptions.slaveId,
+        });
+        validateSerialOptions(mergedValidationOptions, effectiveMetadata);
+    }
+    // Create transport with merged options
+    return await withTransport(mergedOptions, async (transport) => {
+        // Create driver instance
+        return await withDriverInstance(transport, driverMetadata, mergedOptions.slaveId, options.device, async (driver) => {
+            // Execute callback with driver and merged options
+            return await fn(driver, mergedOptions);
+        });
+    });
+}
+//# sourceMappingURL=commands.js.map

package/dist/src/utils/commands.js.map

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

package/dist/src/utils/object-utils.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Object utility functions
+ */
+/**
+ * Remove undefined properties from an object
+ *
+ * Creates a new object with all properties that are not undefined.
+ * Preserves null, false, 0, empty string, and other falsy values.
+ *
+ * @param obj - Source object
+ * @returns New object without undefined properties
+ *
+ * @example
+ * ```typescript
+ * omitUndefined({ a: 1, b: undefined, c: 'hello' })
+ * // Returns: { a: 1, c: 'hello' }
+ * ```
+ */
+export declare function omitUndefined<T extends Record<string, unknown>>(obj: T): Partial<T>;
+//# sourceMappingURL=object-utils.d.ts.map

package/dist/src/utils/object-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-utils.d.ts","sourceRoot":"","sources":["../../../src/utils/object-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAUnF"}

package/dist/src/utils/object-utils.js

@@ -0,0 +1,28 @@
+/**
+ * Object utility functions
+ */
+/**
+ * Remove undefined properties from an object
+ *
+ * Creates a new object with all properties that are not undefined.
+ * Preserves null, false, 0, empty string, and other falsy values.
+ *
+ * @param obj - Source object
+ * @returns New object without undefined properties
+ *
+ * @example
+ * ```typescript
+ * omitUndefined({ a: 1, b: undefined, c: 'hello' })
+ * // Returns: { a: 1, c: 'hello' }
+ * ```
+ */
+export function omitUndefined(obj) {
+    const result = {};
+    for (const key in obj) {
+        if (obj[key] !== undefined) {
+            result[key] = obj[key];
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=object-utils.js.map

package/dist/src/utils/object-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-utils.js","sourceRoot":"","sources":["../../../src/utils/object-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,aAAa,CAAoC,GAAM;IACrE,MAAM,MAAM,GAAe,EAAE,CAAA;IAE7B,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;QACtB,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;YAC3B,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAA;QACxB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/src/utils/validation.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Validation utilities for CLI options using driver SUPPORTED_CONFIG
+ */
+import type { LoadedDriver } from '@ya-modbus/driver-loader';
+/**
+ * Validation error with helpful context
+ */
+export declare class ValidationError extends Error {
+    readonly field: string;
+    readonly value: unknown;
+    readonly validValues?: readonly unknown[] | undefined;
+    constructor(message: string, field: string, value: unknown, validValues?: readonly unknown[] | undefined);
+}
+/**
+ * Validate baud rate against driver constraints
+ *
+ * @param baudRate - User-specified baud rate
+ * @param driverMetadata - Loaded driver metadata
+ * @throws ValidationError if invalid
+ */
+export declare function validateBaudRate(baudRate: number | undefined, driverMetadata?: LoadedDriver): void;
+/**
+ * Validate parity against driver constraints
+ *
+ * @param parity - User-specified parity
+ * @param driverMetadata - Loaded driver metadata
+ * @throws ValidationError if invalid
+ */
+export declare function validateParity(parity: string | undefined, driverMetadata?: LoadedDriver): void;
+/**
+ * Validate data bits against driver constraints
+ *
+ * @param dataBits - User-specified data bits
+ * @param driverMetadata - Loaded driver metadata
+ * @throws ValidationError if invalid
+ */
+export declare function validateDataBits(dataBits: number | undefined, driverMetadata?: LoadedDriver): void;
+/**
+ * Validate stop bits against driver constraints
+ *
+ * @param stopBits - User-specified stop bits
+ * @param driverMetadata - Loaded driver metadata
+ * @throws ValidationError if invalid
+ */
+export declare function validateStopBits(stopBits: number | undefined, driverMetadata?: LoadedDriver): void;
+/**
+ * Validate slave ID/address against driver constraints
+ *
+ * @param slaveId - User-specified slave ID
+ * @param driverMetadata - Loaded driver metadata
+ * @throws ValidationError if invalid
+ */
+export declare function validateSlaveId(slaveId: number | undefined, driverMetadata?: LoadedDriver): void;
+/**
+ * Validate all serial connection parameters
+ *
+ * Validates baudRate, parity, dataBits, stopBits, and slaveId against driver constraints.
+ *
+ * @param options - Connection options to validate
+ * @param driverMetadata - Loaded driver metadata
+ * @throws ValidationError if any parameter is invalid
+ */
+export declare function validateSerialOptions(options: {
+    baudRate?: number;
+    parity?: string;
+    dataBits?: number;
+    stopBits?: number;
+    slaveId?: number;
+}, driverMetadata?: LoadedDriver): void;
+//# sourceMappingURL=validation.d.ts.map

package/dist/src/utils/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../../src/utils/validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAG5D;;GAEG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,KAAK,EAAE,MAAM;aACb,KAAK,EAAE,OAAO;aACd,WAAW,CAAC,EAAE,SAAS,OAAO,EAAE;gBAHhD,OAAO,EAAE,MAAM,EACC,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,EACd,WAAW,CAAC,EAAE,SAAS,OAAO,EAAE,YAAA;CAKnD;AAcD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,cAAc,CAAC,EAAE,YAAY,GAC5B,IAAI,CAwBN;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,cAAc,CAAC,EAAE,YAAY,GAAG,IAAI,CAwB9F;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,cAAc,CAAC,EAAE,YAAY,GAC5B,IAAI,CAwBN;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,cAAc,CAAC,EAAE,YAAY,GAC5B,IAAI,CAwBN;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,EAAE,cAAc,CAAC,EAAE,YAAY,GAAG,IAAI,CAuBhG;AAED;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,EACD,cAAc,CAAC,EAAE,YAAY,GAC5B,IAAI,CAMN"}