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

package/dist/config-validator.js

@@ -0,0 +1,315 @@
+"use strict";
+/**
+ * Runtime validation for driver configuration exports
+ *
+ * Validates DEFAULT_CONFIG, SUPPORTED_CONFIG, and DEVICES from third-party drivers
+ * to ensure type safety at runtime.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.outputConfigWarnings = outputConfigWarnings;
+exports.validateDefaultConfig = validateDefaultConfig;
+exports.validateSupportedConfig = validateSupportedConfig;
+exports.validateDevices = validateDevices;
+exports.crossValidateConfigs = crossValidateConfigs;
+const errors_js_1 = require("./errors.js");
+/**
+ * Output configuration warnings to logger
+ *
+ * @param context - Context description (e.g., "Driver DEFAULT_CONFIG")
+ * @param warnings - Array of warning messages
+ * @param logger - Logger to output warnings to
+ */
+function outputConfigWarnings(context, warnings, logger = console) {
+    logger.warn(`\nWarning: ${context} has configuration inconsistencies:`);
+    for (const warning of warnings) {
+        logger.warn(`  - ${warning}`);
+    }
+    logger.warn('  This may indicate a driver authoring error\n');
+    logger.warn('Run: ya-modbus show-defaults --driver <package> to inspect configuration\n');
+}
+/**
+ * Validate that a value is in an array constraint
+ *
+ * @param value - Value to validate
+ * @param validValues - Array of valid values
+ * @param fieldName - Field name for error message
+ * @param constraintName - Constraint array name for error message
+ * @returns Warning message if validation fails, undefined otherwise
+ */
+function validateArrayConstraint(value, validValues, fieldName, constraintName) {
+    if (!validValues.includes(value)) {
+        // TypeScript narrows the type in each branch, so no need for String() conversions
+        const formattedValues = typeof value === 'string'
+            ? validValues.map((v) => `"${v}"`).join(', ')
+            : validValues.join(', ');
+        const formattedValue = typeof value === 'string' ? `"${value}"` : value;
+        return `${fieldName}: ${formattedValue} is not in ${constraintName}: [${formattedValues}]`;
+    }
+    return undefined;
+}
+/**
+ * Validate DEFAULT_CONFIG export from a driver module
+ *
+ * @param config - The DEFAULT_CONFIG value to validate
+ * @returns Validated config
+ * @throws Error with helpful message if validation fails
+ */
+function validateDefaultConfig(config) {
+    if (config === null || config === undefined || typeof config !== 'object') {
+        throw new errors_js_1.ValidationError('Invalid DEFAULT_CONFIG: must be an object.\n' +
+            'Fix: export const DEFAULT_CONFIG = { baudRate: 9600, ... }', 'DEFAULT_CONFIG');
+    }
+    const configObj = config;
+    if ('baudRate' in configObj) {
+        validateSerialDefaultConfig(configObj);
+    }
+    else if ('defaultPort' in configObj) {
+        validateTcpDefaultConfig(configObj);
+    }
+    else {
+        throw new errors_js_1.ValidationError('Invalid DEFAULT_CONFIG: must have either "baudRate" (serial) or "defaultPort" (TCP).\n' +
+            'Fix: export const DEFAULT_CONFIG = { baudRate: 9600, ... } // for serial\n' +
+            'Or:  export const DEFAULT_CONFIG = { defaultPort: 502, ... } // for TCP', 'DEFAULT_CONFIG');
+    }
+    return config;
+}
+/**
+ * Validate serial DEFAULT_CONFIG properties
+ */
+function validateSerialDefaultConfig(config) {
+    if (typeof config['baudRate'] !== 'number') {
+        throw new errors_js_1.ValidationError(`Invalid DEFAULT_CONFIG: baudRate must be a number, got ${typeof config['baudRate']}.\n` +
+            'Fix: export const DEFAULT_CONFIG = { baudRate: 9600, ... } // number, not string', 'baudRate');
+    }
+    if ('parity' in config && typeof config['parity'] !== 'string') {
+        throw new errors_js_1.ValidationError(`Invalid DEFAULT_CONFIG: parity must be a string, got ${typeof config['parity']}.\n` +
+            'Fix: export const DEFAULT_CONFIG = { parity: "even", ... } // string: "none", "even", or "odd"', 'parity');
+    }
+    if ('dataBits' in config && typeof config['dataBits'] !== 'number') {
+        throw new errors_js_1.ValidationError(`Invalid DEFAULT_CONFIG: dataBits must be a number, got ${typeof config['dataBits']}.\n` +
+            'Fix: export const DEFAULT_CONFIG = { dataBits: 8, ... } // number: 7 or 8', 'dataBits');
+    }
+    if ('stopBits' in config && typeof config['stopBits'] !== 'number') {
+        throw new errors_js_1.ValidationError(`Invalid DEFAULT_CONFIG: stopBits must be a number, got ${typeof config['stopBits']}.\n` +
+            'Fix: export const DEFAULT_CONFIG = { stopBits: 1, ... } // number: 1 or 2', 'stopBits');
+    }
+    if ('defaultAddress' in config && typeof config['defaultAddress'] !== 'number') {
+        throw new errors_js_1.ValidationError(`Invalid DEFAULT_CONFIG: defaultAddress must be a number, got ${typeof config['defaultAddress']}.\n` +
+            'Fix: export const DEFAULT_CONFIG = { defaultAddress: 1, ... } // number: 1-247', 'defaultAddress');
+    }
+}
+/**
+ * Validate TCP DEFAULT_CONFIG properties
+ */
+function validateTcpDefaultConfig(config) {
+    if (typeof config['defaultPort'] !== 'number') {
+        throw new errors_js_1.ValidationError(`Invalid DEFAULT_CONFIG: defaultPort must be a number, got ${typeof config['defaultPort']}.\n` +
+            'Fix: export const DEFAULT_CONFIG = { defaultPort: 502, ... } // number', 'defaultPort');
+    }
+    if ('defaultAddress' in config && typeof config['defaultAddress'] !== 'number') {
+        throw new errors_js_1.ValidationError(`Invalid DEFAULT_CONFIG: defaultAddress must be a number, got ${typeof config['defaultAddress']}.\n` +
+            'Fix: export const DEFAULT_CONFIG = { defaultAddress: 1, ... } // number: 1-247', 'defaultAddress');
+    }
+}
+/**
+ * Validate SUPPORTED_CONFIG export from a driver module
+ *
+ * @param config - The SUPPORTED_CONFIG value to validate
+ * @returns Validated config
+ * @throws Error with helpful message if validation fails
+ */
+function validateSupportedConfig(config) {
+    if (config === null || config === undefined || typeof config !== 'object') {
+        throw new errors_js_1.ValidationError('Invalid SUPPORTED_CONFIG: must be an object.\n' +
+            'Fix: export const SUPPORTED_CONFIG = { validBaudRates: [9600, 19200], ... }', 'SUPPORTED_CONFIG');
+    }
+    const configObj = config;
+    if ('validBaudRates' in configObj && !Array.isArray(configObj['validBaudRates'])) {
+        throw new errors_js_1.ValidationError(`Invalid SUPPORTED_CONFIG: validBaudRates must be an array, got ${typeof configObj['validBaudRates']}.\n` +
+            'Fix: export const SUPPORTED_CONFIG = { validBaudRates: [9600, 19200], ... }', 'validBaudRates');
+    }
+    if ('validParity' in configObj && !Array.isArray(configObj['validParity'])) {
+        throw new errors_js_1.ValidationError(`Invalid SUPPORTED_CONFIG: validParity must be an array, got ${typeof configObj['validParity']}.\n` +
+            'Fix: export const SUPPORTED_CONFIG = { validParity: ["none", "even", "odd"], ... }', 'validParity');
+    }
+    if ('validDataBits' in configObj && !Array.isArray(configObj['validDataBits'])) {
+        throw new errors_js_1.ValidationError(`Invalid SUPPORTED_CONFIG: validDataBits must be an array, got ${typeof configObj['validDataBits']}.\n` +
+            'Fix: export const SUPPORTED_CONFIG = { validDataBits: [7, 8], ... }', 'validDataBits');
+    }
+    if ('validStopBits' in configObj && !Array.isArray(configObj['validStopBits'])) {
+        throw new errors_js_1.ValidationError(`Invalid SUPPORTED_CONFIG: validStopBits must be an array, got ${typeof configObj['validStopBits']}.\n` +
+            'Fix: export const SUPPORTED_CONFIG = { validStopBits: [1, 2], ... }', 'validStopBits');
+    }
+    if ('validAddressRange' in configObj) {
+        if (!Array.isArray(configObj['validAddressRange'])) {
+            throw new errors_js_1.ValidationError(`Invalid SUPPORTED_CONFIG: validAddressRange must be an array, got ${typeof configObj['validAddressRange']}.\n` +
+                'Fix: export const SUPPORTED_CONFIG = { validAddressRange: [1, 247], ... }', 'validAddressRange');
+        }
+        const range = configObj['validAddressRange'];
+        if (range.length !== 2) {
+            throw new errors_js_1.ValidationError(`Invalid SUPPORTED_CONFIG: validAddressRange must be a 2-element array [min, max], got ${range.length} elements.\n` +
+                'Fix: export const SUPPORTED_CONFIG = { validAddressRange: [1, 247], ... }', 'validAddressRange');
+        }
+    }
+    if ('validPorts' in configObj && !Array.isArray(configObj['validPorts'])) {
+        throw new errors_js_1.ValidationError(`Invalid SUPPORTED_CONFIG: validPorts must be an array, got ${typeof configObj['validPorts']}.\n` +
+            'Fix: export const SUPPORTED_CONFIG = { validPorts: [502], ... }', 'validPorts');
+    }
+    return config;
+}
+/**
+ * Validate DEVICES export from a driver module
+ *
+ * @param devices - The DEVICES value to validate
+ * @param logger - Optional logger for warnings (defaults to console)
+ * @returns Validated devices registry
+ * @throws Error with helpful message if validation fails
+ */
+function validateDevices(devices, logger = console) {
+    if (devices === null || devices === undefined || typeof devices !== 'object') {
+        throw new errors_js_1.ValidationError('Invalid DEVICES: must be an object.\n' +
+            "Fix: export const DEVICES = { 'device-key': { manufacturer: 'Acme', model: 'X1' } }", 'DEVICES');
+    }
+    if (Array.isArray(devices)) {
+        throw new errors_js_1.ValidationError('Invalid DEVICES: must be an object, not an array.\n' +
+            "Fix: export const DEVICES = { 'device-key': { manufacturer: 'Acme', model: 'X1' } }", 'DEVICES');
+    }
+    const devicesObj = devices;
+    const entries = Object.entries(devicesObj);
+    if (entries.length === 0) {
+        throw new errors_js_1.ValidationError('Invalid DEVICES: must contain at least one device.\n' +
+            "Fix: export const DEVICES = { 'device-key': { manufacturer: 'Acme', model: 'X1' } }", 'DEVICES');
+    }
+    for (const [key, device] of entries) {
+        if (device === null || device === undefined || typeof device !== 'object') {
+            throw new errors_js_1.ValidationError(`Invalid DEVICES["${key}"]: must be an object.\n` +
+                `Fix: DEVICES["${key}"] = { manufacturer: 'Acme', model: 'X1' }`, `DEVICES["${key}"]`);
+        }
+        const deviceObj = device;
+        if (typeof deviceObj['manufacturer'] !== 'string') {
+            throw new errors_js_1.ValidationError(`Invalid DEVICES["${key}"]: manufacturer must be a string.\n` +
+                `Fix: DEVICES["${key}"] = { manufacturer: 'Acme', ... }`, `DEVICES["${key}"].manufacturer`);
+        }
+        if (typeof deviceObj['model'] !== 'string') {
+            throw new errors_js_1.ValidationError(`Invalid DEVICES["${key}"]: model must be a string.\n` +
+                `Fix: DEVICES["${key}"] = { model: 'X1', ... }`, `DEVICES["${key}"].model`);
+        }
+        if ('description' in deviceObj && typeof deviceObj['description'] !== 'string') {
+            throw new errors_js_1.ValidationError(`Invalid DEVICES["${key}"]: description must be a string.\n` +
+                `Fix: DEVICES["${key}"] = { description: 'A device', ... }`, `DEVICES["${key}"].description`);
+        }
+        let validatedDefaultConfig;
+        if ('defaultConfig' in deviceObj && deviceObj['defaultConfig'] !== undefined) {
+            try {
+                validatedDefaultConfig = validateDefaultConfig(deviceObj['defaultConfig']);
+            }
+            catch (error) {
+                if (error instanceof errors_js_1.ValidationError) {
+                    throw new errors_js_1.ValidationError(`Invalid DEVICES["${key}"].defaultConfig: ${error.message}`, `DEVICES["${key}"].defaultConfig${error.field ? `.${error.field}` : ''}`);
+                }
+                throw error;
+            }
+        }
+        let validatedSupportedConfig;
+        if ('supportedConfig' in deviceObj && deviceObj['supportedConfig'] !== undefined) {
+            try {
+                validatedSupportedConfig = validateSupportedConfig(deviceObj['supportedConfig']);
+            }
+            catch (error) {
+                if (error instanceof errors_js_1.ValidationError) {
+                    throw new errors_js_1.ValidationError(`Invalid DEVICES["${key}"].supportedConfig: ${error.message}`, `DEVICES["${key}"].supportedConfig${error.field ? `.${error.field}` : ''}`);
+                }
+                throw error;
+            }
+        }
+        if (validatedDefaultConfig && validatedSupportedConfig) {
+            const warnings = crossValidateConfigs(validatedDefaultConfig, validatedSupportedConfig);
+            if (warnings.length > 0) {
+                outputConfigWarnings(`DEVICES["${key}"]`, warnings, logger);
+            }
+        }
+    }
+    return devices;
+}
+/**
+ * Helper function to validate if a value is within a numeric range
+ */
+function validateAddressRange(value, range, fieldName) {
+    const [min, max] = range;
+    if (value < min || value > max) {
+        return `${fieldName}: ${value} is not in validAddressRange: [${min}, ${max}]`;
+    }
+    return undefined;
+}
+/**
+ * Cross-validate DEFAULT_CONFIG against SUPPORTED_CONFIG constraints
+ *
+ * Checks that all DEFAULT_CONFIG values are within SUPPORTED_CONFIG constraints.
+ * This helps catch driver authoring errors where defaults don't match declared support.
+ *
+ * @param defaultConfig - The validated DEFAULT_CONFIG
+ * @param supportedConfig - The validated SUPPORTED_CONFIG
+ * @returns Array of warning messages for any inconsistencies found (empty if all valid)
+ */
+function crossValidateConfigs(defaultConfig, supportedConfig) {
+    const warnings = [];
+    const isSerial = 'baudRate' in defaultConfig;
+    const isTCP = 'defaultPort' in defaultConfig;
+    if (isSerial) {
+        const serialDefault = defaultConfig;
+        const serialSupported = supportedConfig;
+        if ('validBaudRates' in serialSupported && Array.isArray(serialSupported['validBaudRates'])) {
+            const warning = validateArrayConstraint(serialDefault.baudRate, serialSupported['validBaudRates'], 'baudRate', 'validBaudRates');
+            if (warning)
+                warnings.push(warning);
+        }
+        if ('parity' in serialDefault &&
+            'validParity' in serialSupported &&
+            Array.isArray(serialSupported['validParity'])) {
+            const warning = validateArrayConstraint(serialDefault.parity, serialSupported['validParity'], 'parity', 'validParity');
+            if (warning)
+                warnings.push(warning);
+        }
+        if ('dataBits' in serialDefault &&
+            'validDataBits' in serialSupported &&
+            Array.isArray(serialSupported['validDataBits'])) {
+            const warning = validateArrayConstraint(serialDefault.dataBits, serialSupported['validDataBits'], 'dataBits', 'validDataBits');
+            if (warning)
+                warnings.push(warning);
+        }
+        if ('stopBits' in serialDefault &&
+            'validStopBits' in serialSupported &&
+            Array.isArray(serialSupported['validStopBits'])) {
+            const warning = validateArrayConstraint(serialDefault.stopBits, serialSupported['validStopBits'], 'stopBits', 'validStopBits');
+            if (warning)
+                warnings.push(warning);
+        }
+        if ('defaultAddress' in serialDefault &&
+            'validAddressRange' in serialSupported &&
+            Array.isArray(serialSupported['validAddressRange'])) {
+            const warning = validateAddressRange(serialDefault.defaultAddress, serialSupported['validAddressRange'], 'defaultAddress');
+            if (warning) {
+                warnings.push(warning);
+            }
+        }
+    }
+    else if (isTCP) {
+        const tcpDefault = defaultConfig;
+        const tcpSupported = supportedConfig;
+        if ('validPorts' in tcpSupported && Array.isArray(tcpSupported['validPorts'])) {
+            const warning = validateArrayConstraint(tcpDefault.defaultPort, tcpSupported['validPorts'], 'defaultPort', 'validPorts');
+            if (warning)
+                warnings.push(warning);
+        }
+        if ('defaultAddress' in tcpDefault &&
+            'validAddressRange' in tcpSupported &&
+            Array.isArray(tcpSupported['validAddressRange'])) {
+            const warning = validateAddressRange(tcpDefault.defaultAddress, tcpSupported['validAddressRange'], 'defaultAddress');
+            if (warning) {
+                warnings.push(warning);
+            }
+        }
+    }
+    return warnings;
+}
+//# sourceMappingURL=config-validator.js.map

package/dist/config-validator.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Custom error classes for driver-loader
+ *
+ * These error classes provide better error handling and type safety
+ * compared to string-based error detection.
+ */
+/**
+ * Error thrown when driver configuration validation fails
+ *
+ * @example
+ * ```typescript
+ * import { loadDriver, ValidationError } from '@ya-modbus/driver-loader'
+ *
+ * try {
+ *   await loadDriver({ driverPackage: 'my-driver' })
+ * } catch (error) {
+ *   if (error instanceof ValidationError) {
+ *     console.error(`Validation failed for field: ${error.field}`)
+ *     console.error(`Message: ${error.message}`)
+ *   }
+ * }
+ * ```
+ */
+export declare class ValidationError extends Error {
+    readonly field?: string | undefined;
+    constructor(message: string, field?: string | undefined);
+}
+/**
+ * Error thrown when a driver package cannot be found or loaded
+ *
+ * @example
+ * ```typescript
+ * import { loadDriver, DriverNotFoundError } from '@ya-modbus/driver-loader'
+ *
+ * try {
+ *   await loadDriver({ driverPackage: 'missing-driver' })
+ * } catch (error) {
+ *   if (error instanceof DriverNotFoundError) {
+ *     console.error(`Package not found: ${error.packageName}`)
+ *     console.error(`Install with: npm install ${error.packageName}`)
+ *   }
+ * }
+ * ```
+ */
+export declare class DriverNotFoundError extends Error {
+    readonly packageName: string;
+    constructor(message: string, packageName: string);
+}
+/**
+ * Error thrown when package.json is not found or invalid
+ *
+ * @example
+ * ```typescript
+ * import { loadDriver, PackageJsonError } from '@ya-modbus/driver-loader'
+ *
+ * try {
+ *   await loadDriver({}) // Auto-detect from current directory
+ * } catch (error) {
+ *   if (error instanceof PackageJsonError) {
+ *     console.error('package.json issue:', error.message)
+ *     // Examples: missing file, invalid JSON, missing keywords
+ *   }
+ * }
+ * ```
+ */
+export declare class PackageJsonError extends Error {
+    constructor(message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,KAAK,CAAC,EAAE,MAAM;gBAD9B,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,MAAM,YAAA;CAMjC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAG1B,WAAW,EAAE,MAAM;gBADnC,OAAO,EAAE,MAAM,EACC,WAAW,EAAE,MAAM;CAMtC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAK5B"}

package/dist/errors.js

@@ -0,0 +1,89 @@
+"use strict";
+/**
+ * Custom error classes for driver-loader
+ *
+ * These error classes provide better error handling and type safety
+ * compared to string-based error detection.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PackageJsonError = exports.DriverNotFoundError = exports.ValidationError = void 0;
+/**
+ * Error thrown when driver configuration validation fails
+ *
+ * @example
+ * ```typescript
+ * import { loadDriver, ValidationError } from '@ya-modbus/driver-loader'
+ *
+ * try {
+ *   await loadDriver({ driverPackage: 'my-driver' })
+ * } catch (error) {
+ *   if (error instanceof ValidationError) {
+ *     console.error(`Validation failed for field: ${error.field}`)
+ *     console.error(`Message: ${error.message}`)
+ *   }
+ * }
+ * ```
+ */
+class ValidationError extends Error {
+    field;
+    constructor(message, field) {
+        super(message);
+        this.field = field;
+        this.name = 'ValidationError';
+        Object.setPrototypeOf(this, ValidationError.prototype);
+    }
+}
+exports.ValidationError = ValidationError;
+/**
+ * Error thrown when a driver package cannot be found or loaded
+ *
+ * @example
+ * ```typescript
+ * import { loadDriver, DriverNotFoundError } from '@ya-modbus/driver-loader'
+ *
+ * try {
+ *   await loadDriver({ driverPackage: 'missing-driver' })
+ * } catch (error) {
+ *   if (error instanceof DriverNotFoundError) {
+ *     console.error(`Package not found: ${error.packageName}`)
+ *     console.error(`Install with: npm install ${error.packageName}`)
+ *   }
+ * }
+ * ```
+ */
+class DriverNotFoundError extends Error {
+    packageName;
+    constructor(message, packageName) {
+        super(message);
+        this.packageName = packageName;
+        this.name = 'DriverNotFoundError';
+        Object.setPrototypeOf(this, DriverNotFoundError.prototype);
+    }
+}
+exports.DriverNotFoundError = DriverNotFoundError;
+/**
+ * Error thrown when package.json is not found or invalid
+ *
+ * @example
+ * ```typescript
+ * import { loadDriver, PackageJsonError } from '@ya-modbus/driver-loader'
+ *
+ * try {
+ *   await loadDriver({}) // Auto-detect from current directory
+ * } catch (error) {
+ *   if (error instanceof PackageJsonError) {
+ *     console.error('package.json issue:', error.message)
+ *     // Examples: missing file, invalid JSON, missing keywords
+ *   }
+ * }
+ * ```
+ */
+class PackageJsonError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PackageJsonError';
+        Object.setPrototypeOf(this, PackageJsonError.prototype);
+    }
+}
+exports.PackageJsonError = PackageJsonError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,eAAgB,SAAQ,KAAK;IAGtB;IAFlB,YACE,OAAe,EACC,KAAc;QAE9B,KAAK,CAAC,OAAO,CAAC,CAAA;QAFE,UAAK,GAAL,KAAK,CAAS;QAG9B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;QAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAA;IACxD,CAAC;CACF;AATD,0CASC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,mBAAoB,SAAQ,KAAK;IAG1B;IAFlB,YACE,OAAe,EACC,WAAmB;QAEnC,KAAK,CAAC,OAAO,CAAC,CAAA;QAFE,gBAAW,GAAX,WAAW,CAAQ;QAGnC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAA;IAC5D,CAAC;CACF;AATD,kDASC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAA;QAC9B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,gBAAgB,CAAC,SAAS,CAAC,CAAA;IACzD,CAAC;CACF;AAND,4CAMC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { loadDriver, clearDriverCache, getDriverCacheStats } from './loader.js';
+export type { LoadedDriver, LoadDriverOptions, SystemDependencies, DriverCacheStats, Logger, } from './loader.js';
+export { validateDefaultConfig, validateSupportedConfig, validateDevices, crossValidateConfigs, } from './config-validator.js';
+export { ValidationError, DriverNotFoundError, PackageJsonError } from './errors.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAC/E,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,MAAM,GACP,MAAM,aAAa,CAAA;AACpB,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,eAAe,EACf,oBAAoB,GACrB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PackageJsonError = exports.DriverNotFoundError = exports.ValidationError = exports.crossValidateConfigs = exports.validateDevices = exports.validateSupportedConfig = exports.validateDefaultConfig = exports.getDriverCacheStats = exports.clearDriverCache = exports.loadDriver = void 0;
+var loader_js_1 = require("./loader.js");
+Object.defineProperty(exports, "loadDriver", { enumerable: true, get: function () { return loader_js_1.loadDriver; } });
+Object.defineProperty(exports, "clearDriverCache", { enumerable: true, get: function () { return loader_js_1.clearDriverCache; } });
+Object.defineProperty(exports, "getDriverCacheStats", { enumerable: true, get: function () { return loader_js_1.getDriverCacheStats; } });
+var config_validator_js_1 = require("./config-validator.js");
+Object.defineProperty(exports, "validateDefaultConfig", { enumerable: true, get: function () { return config_validator_js_1.validateDefaultConfig; } });
+Object.defineProperty(exports, "validateSupportedConfig", { enumerable: true, get: function () { return config_validator_js_1.validateSupportedConfig; } });
+Object.defineProperty(exports, "validateDevices", { enumerable: true, get: function () { return config_validator_js_1.validateDevices; } });
+Object.defineProperty(exports, "crossValidateConfigs", { enumerable: true, get: function () { return config_validator_js_1.crossValidateConfigs; } });
+var errors_js_1 = require("./errors.js");
+Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_js_1.ValidationError; } });
+Object.defineProperty(exports, "DriverNotFoundError", { enumerable: true, get: function () { return errors_js_1.DriverNotFoundError; } });
+Object.defineProperty(exports, "PackageJsonError", { enumerable: true, get: function () { return errors_js_1.PackageJsonError; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,yCAA+E;AAAtE,uGAAA,UAAU,OAAA;AAAE,6GAAA,gBAAgB,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AAQ1D,6DAK8B;AAJ5B,4HAAA,qBAAqB,OAAA;AACrB,8HAAA,uBAAuB,OAAA;AACvB,sHAAA,eAAe,OAAA;AACf,2HAAA,oBAAoB,OAAA;AAEtB,yCAAoF;AAA3E,4GAAA,eAAe,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AAAE,6GAAA,gBAAgB,OAAA"}

package/dist/loader.d.ts

@@ -0,0 +1,122 @@
+import type { CreateDriverFunction, DefaultConfig, DeviceRegistry, SupportedConfig } from '@ya-modbus/driver-types';
+/**
+ * Loaded driver module with configuration metadata
+ */
+export interface LoadedDriver {
+    /** Driver factory function */
+    createDriver: CreateDriverFunction;
+    /** Registry of supported devices (for multi-device drivers) */
+    devices?: DeviceRegistry;
+    /** Factory-default device configuration (if provided by driver) */
+    defaultConfig?: DefaultConfig;
+    /** Supported configuration constraints (if provided by driver) */
+    supportedConfig?: SupportedConfig;
+}
+/**
+ * Logger interface for driver loading
+ *
+ * @example
+ * ```typescript
+ * import { loadDriver, type Logger } from '@ya-modbus/driver-loader'
+ *
+ * const logger: Logger = {
+ *   warn: (msg) => console.warn('[DRIVER]', msg),
+ *   debug: (msg) => console.debug('[DRIVER]', msg), // Optional
+ * }
+ *
+ * const driver = await loadDriver({ logger })
+ * ```
+ */
+export interface Logger {
+    /** Log warning messages */
+    warn: (message: string) => void;
+    /** Log debug messages (optional) */
+    debug?: (message: string) => void;
+}
+/**
+ * Driver loading options
+ *
+ * @example
+ * ```typescript
+ * import { loadDriver } from '@ya-modbus/driver-loader'
+ *
+ * // Auto-detect from current directory
+ * const driver1 = await loadDriver({})
+ *
+ * // Load specific package
+ * const driver2 = await loadDriver({ driverPackage: 'ya-modbus-driver-xymd1' })
+ *
+ * // With custom logger
+ * const driver3 = await loadDriver({
+ *   driverPackage: 'my-driver',
+ *   logger: {
+ *     warn: (msg) => console.warn('[WARN]', msg),
+ *     debug: (msg) => console.debug('[DEBUG]', msg),
+ *   }
+ * })
+ * ```
+ */
+export interface LoadDriverOptions {
+    /**
+     * Explicit driver package name
+     * e.g., 'ya-modbus-driver-xymd1' or '@org/driver-pkg'
+     */
+    driverPackage?: string;
+    /**
+     * Custom logger for warnings and debug messages
+     * Defaults to console if not provided
+     */
+    logger?: Logger;
+}
+/**
+ * System dependencies for driver loading (for dependency injection)
+ */
+export interface SystemDependencies {
+    readFile: (path: string, encoding: 'utf-8') => Promise<string>;
+    importModule: (modulePath: string) => Promise<unknown>;
+    getCwd: () => string;
+}
+/**
+ * Driver cache statistics
+ */
+export interface DriverCacheStats {
+    /** Number of cache hits */
+    hits: number;
+    /** Number of cache misses */
+    misses: number;
+    /** Number of cached drivers */
+    size: number;
+}
+/**
+ * Clear the driver cache
+ * Useful for testing or when you need to reload drivers
+ */
+export declare function clearDriverCache(): void;
+/**
+ * Get cache statistics
+ * @returns Current cache statistics including hits, misses, and size
+ */
+export declare function getDriverCacheStats(): DriverCacheStats;
+/**
+ * Load a driver package dynamically
+ *
+ * Supports two modes:
+ * 1. Explicit package: `loadDriver({ driverPackage: 'ya-modbus-driver-xymd1' })`
+ * 2. Auto-detect from cwd: `loadDriver({})` - reads package.json from current directory
+ *
+ * Auto-detection checks for `ya-modbus-driver` keyword in package.json keywords.
+ *
+ * @example
+ * // Auto-detect from current directory
+ * const driver = await loadDriver({})
+ *
+ * // Load explicit package
+ * const driver = await loadDriver({ driverPackage: 'ya-modbus-driver-xymd1' })
+ *
+ * @param options - Loading options (defaults to local package detection)
+ * @param deps - System dependencies (for testing, uses Node.js built-ins by default)
+ * @returns Loaded driver with createDriver function and optional configuration metadata
+ * @throws Error if driver cannot be loaded or is invalid
+ */
+export declare function loadDriver(options?: LoadDriverOptions, deps?: SystemDependencies): Promise<LoadedDriver>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,eAAe,EAChB,MAAM,yBAAyB,CAAA;AAWhC;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,8BAA8B;IAC9B,YAAY,EAAE,oBAAoB,CAAA;IAElC,+DAA+D;IAC/D,OAAO,CAAC,EAAE,cAAc,CAAA;IAExB,mEAAmE;IACnE,aAAa,CAAC,EAAE,aAAa,CAAA;IAE7B,kEAAkE;IAClE,eAAe,CAAC,EAAE,eAAe,CAAA;CAClC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,MAAM;IACrB,2BAA2B;IAC3B,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;IAC/B,oCAAoC;IACpC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CAClC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;IAC9D,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACtD,MAAM,EAAE,MAAM,MAAM,CAAA;CACrB;AAeD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,6BAA6B;IAC7B,MAAM,EAAE,MAAM,CAAA;IACd,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAA;CACb;AAeD;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,IAAI,CAIvC;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CAMtD;AAwED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,UAAU,CAC9B,OAAO,GAAE,iBAAsB,EAC/B,IAAI,GAAE,kBAAgC,GACrC,OAAO,CAAC,YAAY,CAAC,CAsHvB"}