@ya-modbus/driver-loader 0.11.2 → 0.12.0

package/CHANGELOG.md

@@ -3,6 +3,16 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [0.12.0](https://github.com/groupsky/ya-modbus/compare/@ya-modbus/driver-loader@0.11.2...@ya-modbus/driver-loader@0.12.0) (2026-10-14)
+
+### Bug Fixes
+
+- **mqtt-bridge:** use the driver's default serial settings and reject unsupported ones ([#627](https://github.com/groupsky/ya-modbus/issues/627)) ([](https://github.com/groupsky/ya-modbus/commit/)), closes [#609](https://github.com/groupsky/ya-modbus/issues/609)
+
+### BREAKING CHANGES
+
+- **mqtt-bridge:** in mqtt-bridge, a device config without parity used to get "none" and now gets the driver default. Set "parity": "none" to keep the old behavior. A serial setting the driver does not support now stops startup.
+
 ## [0.11.2](https://github.com/groupsky/ya-modbus/compare/@ya-modbus/driver-loader@0.11.1...@ya-modbus/driver-loader@0.11.2) (2026-10-12)
 
 **Note:** Version bump only for package @ya-modbus/driver-loader

package/README.md

@@ -85,9 +85,11 @@ try {
 
 **Error Types:**
 
-- **`ValidationError`**: Driver configuration validation failed
+- **`ValidationError`**: Driver configuration validation failed, or a connection option is not in the driver's `SUPPORTED_CONFIG`
   - `field?: string` - The configuration field that failed validation
-  - Example: Invalid DEFAULT_CONFIG, missing createDriver function
+  - `value?: unknown` - The rejected value, when it is known
+  - `validValues?: readonly unknown[]` - The values that the driver supports, when they are known
+  - Example: Invalid DEFAULT_CONFIG, missing createDriver function, parity `none` for a driver that supports only `odd`
 
 - **`DriverNotFoundError`**: Driver package not found or cannot be loaded
   - `packageName: string` - The package that could not be found or loaded. For a package that is not installed this is the package to install
@@ -249,6 +251,34 @@ assertValidDriverPackageName(config.driver)
 await loadDriver({ driverPackage: config.driver })
 ```
 
+### `validateSerialOptions(options, driver?: LoadedDriver): void`
+
+Checks `baudRate`, `parity`, `dataBits`, `stopBits` and `slaveId` against the driver's `SUPPORTED_CONFIG`. An option that is not set, or that the driver does not limit, passes. A value that the driver does not support throws a `ValidationError` with `field`, `value`, `validValues` and a message such as `Invalid parity 'none'. This driver supports: odd (default: odd)`.
+
+### `applyDriverDefaults(options, driver?: LoadedDriver, device?: string)`
+
+Returns a copy of `options` where each missing `baudRate`, `parity`, `dataBits`, `stopBits` and `slaveId` is taken from the driver's serial `DEFAULT_CONFIG` (`slaveId` from `defaultAddress`). With `device`, the device's `defaultConfig` from `DEVICES` is used when it has one. Options with a `host` (TCP), and options for a driver without a serial `DEFAULT_CONFIG`, are returned unchanged.
+
+### `getEffectiveDriverMetadata(driver: LoadedDriver, device?: string): LoadedDriver`
+
+Returns the driver with `defaultConfig` and `supportedConfig` of the selected device from `DEVICES`, or of the driver when the device has none. Pass the result to `validateSerialOptions` to check the options of a device.
+
+```typescript
+import {
+  applyDriverDefaults,
+  getEffectiveDriverMetadata,
+  loadDriver,
+  validateSerialOptions,
+} from '@ya-modbus/driver-loader'
+
+const driver = await loadDriver({ driverPackage: '@ya-modbus/driver-or-we-516' })
+const effective = getEffectiveDriverMetadata(driver, device)
+
+validateSerialOptions(options, effective) // the options the user set
+const merged = applyDriverDefaults(options, driver, device)
+validateSerialOptions(merged, effective) // catches defaults that the driver does not support
+```
+
 ## Testing Utilities
 
 The package provides testing utilities for applications using driver-loader.

package/dist/cjs/src/driver-defaults.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Driver defaults for connection options: DEFAULT_CONFIG and SUPPORTED_CONFIG of the driver,
+ * or of the selected device in its DEVICES registry
+ */
+import type { DefaultSerialConfig } from '@ya-modbus/driver-types';
+import type { LoadedDriver } from './loader.js';
+/**
+ * Connection options that driver defaults apply to
+ *
+ * `host` marks a TCP connection, which serial defaults do not apply to.
+ */
+export interface SerialOptions {
+    host?: string;
+    baudRate?: number;
+    dataBits?: number;
+    parity?: string;
+    stopBits?: number;
+    slaveId?: number;
+}
+/**
+ * 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 declare function getEffectiveDefaultConfig(driverMetadata: LoadedDriver | undefined, device: string | undefined): DefaultSerialConfig | 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 declare function getEffectiveSupportedConfig(driverMetadata: LoadedDriver | undefined, device: string | undefined): LoadedDriver['supportedConfig'] | undefined;
+/**
+ * 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 declare function getEffectiveDriverMetadata(driverMetadata: LoadedDriver, device?: string): LoadedDriver;
+/**
+ * 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 declare function applyDriverDefaults<T extends SerialOptions>(options: T, driverMetadata?: LoadedDriver, device?: string): T;
+//# sourceMappingURL=driver-defaults.d.ts.map

package/dist/cjs/src/driver-defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"driver-defaults.d.ts","sourceRoot":"","sources":["../../../src/driver-defaults.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAA;AAElE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE/C;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CACvC,cAAc,EAAE,YAAY,GAAG,SAAS,EACxC,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,mBAAmB,GAAG,SAAS,CAoBjC;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,cAAc,EAAE,YAAY,GAAG,SAAS,EACxC,MAAM,EAAE,MAAM,GAAG,SAAS,GACzB,YAAY,CAAC,iBAAiB,CAAC,GAAG,SAAS,CAY7C;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,YAAY,EAC5B,MAAM,CAAC,EAAE,MAAM,GACd,YAAY,CAsBd;AAED;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,aAAa,EACzD,OAAO,EAAE,CAAC,EACV,cAAc,CAAC,EAAE,YAAY,EAC7B,MAAM,CAAC,EAAE,MAAM,GACd,CAAC,CAsBH"}

package/dist/cjs/src/driver-defaults.js

@@ -0,0 +1,117 @@
+"use strict";
+/**
+ * Driver defaults for connection options: DEFAULT_CONFIG and SUPPORTED_CONFIG of the driver,
+ * or of the selected device in its DEVICES registry
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEffectiveDefaultConfig = getEffectiveDefaultConfig;
+exports.getEffectiveSupportedConfig = getEffectiveSupportedConfig;
+exports.getEffectiveDriverMetadata = getEffectiveDriverMetadata;
+exports.applyDriverDefaults = applyDriverDefaults;
+/**
+ * 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
+ */
+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
+ */
+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
+ */
+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
+ */
+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,
+    };
+}
+//# sourceMappingURL=driver-defaults.js.map

package/dist/cjs/src/driver-defaults.js.map

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

package/dist/cjs/src/errors.d.ts

@@ -5,7 +5,11 @@
  * compared to string-based error detection.
  */
 /**
- * Error thrown when driver configuration validation fails
+ * Error thrown when driver configuration validation fails, or when a connection option is not
+ * in the driver's SUPPORTED_CONFIG
+ *
+ * `value` is the rejected value and `validValues` the values that the driver supports, when
+ * they are known.
  *
  * @example
  * ```typescript
@@ -23,7 +27,9 @@
  */
 export declare class ValidationError extends Error {
     readonly field?: string | undefined;
-    constructor(message: string, field?: string | undefined);
+    readonly value?: unknown | undefined;
+    readonly validValues?: readonly unknown[] | undefined;
+    constructor(message: string, field?: string | undefined, value?: unknown | undefined, validValues?: readonly unknown[] | undefined);
 }
 /**
  * Error thrown when a driver package cannot be found or loaded

package/dist/cjs/src/errors.d.ts.map

@@ -1 +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;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAG1B,WAAW,EAAE,MAAM;gBADnC,OAAO,EAAE,MAAM,EACC,WAAW,EAAE,MAAM,EACnC,OAAO,CAAC,EAAE,YAAY;CAMzB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAG1B,WAAW,EAAE,MAAM;gBADnC,OAAO,EAAE,MAAM,EACC,WAAW,EAAE,MAAM,EACnC,OAAO,CAAC,EAAE,YAAY;CAMzB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAK5B"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,eAAgB,SAAQ,KAAK;aAGtB,KAAK,CAAC,EAAE,MAAM;aACd,KAAK,CAAC,EAAE,OAAO;aACf,WAAW,CAAC,EAAE,SAAS,OAAO,EAAE;gBAHhD,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,MAAM,YAAA,EACd,KAAK,CAAC,EAAE,OAAO,YAAA,EACf,WAAW,CAAC,EAAE,SAAS,OAAO,EAAE,YAAA;CAMnD;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAG1B,WAAW,EAAE,MAAM;gBADnC,OAAO,EAAE,MAAM,EACC,WAAW,EAAE,MAAM,EACnC,OAAO,CAAC,EAAE,YAAY;CAMzB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;aAG1B,WAAW,EAAE,MAAM;gBADnC,OAAO,EAAE,MAAM,EACC,WAAW,EAAE,MAAM,EACnC,OAAO,CAAC,EAAE,YAAY;CAMzB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAK5B"}

package/dist/cjs/src/errors.js

@@ -8,7 +8,11 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PackageJsonError = exports.DriverNotBuiltError = exports.DriverNotFoundError = exports.ValidationError = void 0;
 /**
- * Error thrown when driver configuration validation fails
+ * Error thrown when driver configuration validation fails, or when a connection option is not
+ * in the driver's SUPPORTED_CONFIG
+ *
+ * `value` is the rejected value and `validValues` the values that the driver supports, when
+ * they are known.
  *
  * @example
  * ```typescript
@@ -25,9 +29,11 @@ exports.PackageJsonError = exports.DriverNotBuiltError = exports.DriverNotFoundE
  * ```
  */
 class ValidationError extends Error {
-    constructor(message, field) {
+    constructor(message, field, value, validValues) {
         super(message);
         this.field = field;
+        this.value = value;
+        this.validValues = validValues;
         this.name = 'ValidationError';
         Object.setPrototypeOf(this, ValidationError.prototype);
     }

package/dist/cjs/src/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/errors.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAa,eAAgB,SAAQ,KAAK;IACxC,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;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAa,mBAAoB,SAAQ,KAAK;IAC5C,YACE,OAAe,EACC,WAAmB,EACnC,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAHP,gBAAW,GAAX,WAAW,CAAQ;QAInC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAA;IAC5D,CAAC;CACF;AAVD,kDAUC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,mBAAoB,SAAQ,KAAK;IAC5C,YACE,OAAe,EACC,WAAmB,EACnC,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAHP,gBAAW,GAAX,WAAW,CAAQ;QAInC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAA;IAC5D,CAAC;CACF;AAVD,kDAUC;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"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/errors.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAa,eAAgB,SAAQ,KAAK;IACxC,YACE,OAAe,EACC,KAAc,EACd,KAAe,EACf,WAAgC;QAEhD,KAAK,CAAC,OAAO,CAAC,CAAA;QAJE,UAAK,GAAL,KAAK,CAAS;QACd,UAAK,GAAL,KAAK,CAAU;QACf,gBAAW,GAAX,WAAW,CAAqB;QAGhD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAA;QAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,eAAe,CAAC,SAAS,CAAC,CAAA;IACxD,CAAC;CACF;AAXD,0CAWC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAa,mBAAoB,SAAQ,KAAK;IAC5C,YACE,OAAe,EACC,WAAmB,EACnC,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAHP,gBAAW,GAAX,WAAW,CAAQ;QAInC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAA;IAC5D,CAAC;CACF;AAVD,kDAUC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAa,mBAAoB,SAAQ,KAAK;IAC5C,YACE,OAAe,EACC,WAAmB,EACnC,OAAsB;QAEtB,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;QAHP,gBAAW,GAAX,WAAW,CAAQ;QAInC,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAA;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAA;IAC5D,CAAC;CACF;AAVD,kDAUC;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/cjs/src/index.d.ts

@@ -1,6 +1,9 @@
 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 { applyDriverDefaults, getEffectiveDriverMetadata } from './driver-defaults.js';
+export type { SerialOptions } from './driver-defaults.js';
+export { validateSerialOptions } from './serial-validation.js';
 export { DRIVER_PACKAGE_NAME_RULE, assertValidDriverPackageName, isValidDriverPackageName, } from './driver-package-name.js';
 export { ValidationError, DriverNotFoundError, DriverNotBuiltError, PackageJsonError, } from './errors.js';
 export { getCallerPackageInfo } from './package-info.js';

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

@@ -1 +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,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AACxD,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA"}
+{"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,mBAAmB,EAAE,0BAA0B,EAAE,MAAM,sBAAsB,CAAA;AACtF,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACzD,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAC9D,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,wBAAwB,GACzB,MAAM,0BAA0B,CAAA;AACjC,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAA;AACxD,YAAY,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/cjs/src/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getCallerPackageInfo = exports.PackageJsonError = exports.DriverNotBuiltError = exports.DriverNotFoundError = exports.ValidationError = exports.isValidDriverPackageName = exports.assertValidDriverPackageName = exports.DRIVER_PACKAGE_NAME_RULE = exports.crossValidateConfigs = exports.validateDevices = exports.validateSupportedConfig = exports.validateDefaultConfig = exports.getDriverCacheStats = exports.clearDriverCache = exports.loadDriver = void 0;
+exports.getCallerPackageInfo = exports.PackageJsonError = exports.DriverNotBuiltError = exports.DriverNotFoundError = exports.ValidationError = exports.isValidDriverPackageName = exports.assertValidDriverPackageName = exports.DRIVER_PACKAGE_NAME_RULE = exports.validateSerialOptions = exports.getEffectiveDriverMetadata = exports.applyDriverDefaults = 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; } });
@@ -10,6 +10,11 @@ Object.defineProperty(exports, "validateDefaultConfig", { enumerable: true, get:
 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 driver_defaults_js_1 = require("./driver-defaults.js");
+Object.defineProperty(exports, "applyDriverDefaults", { enumerable: true, get: function () { return driver_defaults_js_1.applyDriverDefaults; } });
+Object.defineProperty(exports, "getEffectiveDriverMetadata", { enumerable: true, get: function () { return driver_defaults_js_1.getEffectiveDriverMetadata; } });
+var serial_validation_js_1 = require("./serial-validation.js");
+Object.defineProperty(exports, "validateSerialOptions", { enumerable: true, get: function () { return serial_validation_js_1.validateSerialOptions; } });
 var driver_package_name_js_1 = require("./driver-package-name.js");
 Object.defineProperty(exports, "DRIVER_PACKAGE_NAME_RULE", { enumerable: true, get: function () { return driver_package_name_js_1.DRIVER_PACKAGE_NAME_RULE; } });
 Object.defineProperty(exports, "assertValidDriverPackageName", { enumerable: true, get: function () { return driver_package_name_js_1.assertValidDriverPackageName; } });

package/dist/cjs/src/index.js.map

@@ -1 +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,mEAIiC;AAH/B,kIAAA,wBAAwB,OAAA;AACxB,sIAAA,4BAA4B,OAAA;AAC5B,kIAAA,wBAAwB,OAAA;AAE1B,yCAKoB;AAJlB,4GAAA,eAAe,OAAA;AACf,gHAAA,mBAAmB,OAAA;AACnB,gHAAA,mBAAmB,OAAA;AACnB,6GAAA,gBAAgB,OAAA;AAElB,qDAAwD;AAA/C,uHAAA,oBAAoB,OAAA"}
+{"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,2DAAsF;AAA7E,yHAAA,mBAAmB,OAAA;AAAE,gIAAA,0BAA0B,OAAA;AAExD,+DAA8D;AAArD,6HAAA,qBAAqB,OAAA;AAC9B,mEAIiC;AAH/B,kIAAA,wBAAwB,OAAA;AACxB,sIAAA,4BAA4B,OAAA;AAC5B,kIAAA,wBAAwB,OAAA;AAE1B,yCAKoB;AAJlB,4GAAA,eAAe,OAAA;AACf,gHAAA,mBAAmB,OAAA;AACnB,gHAAA,mBAAmB,OAAA;AACnB,6GAAA,gBAAgB,OAAA;AAElB,qDAAwD;AAA/C,uHAAA,oBAAoB,OAAA"}

package/dist/cjs/src/serial-validation.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Validation of serial connection options against a driver's SUPPORTED_CONFIG
+ */
+import type { LoadedDriver } from './loader.js';
+/**
+ * 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=serial-validation.d.ts.map

package/dist/cjs/src/serial-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serial-validation.d.ts","sourceRoot":"","sources":["../../../src/serial-validation.ts"],"names":[],"mappings":"AAAA;;GAEG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAc/C;;;;;;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"}

package/dist/cjs/src/serial-validation.js

@@ -0,0 +1,152 @@
+"use strict";
+/**
+ * Validation of serial connection options against a driver's SUPPORTED_CONFIG
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateBaudRate = validateBaudRate;
+exports.validateParity = validateParity;
+exports.validateDataBits = validateDataBits;
+exports.validateStopBits = validateStopBits;
+exports.validateSlaveId = validateSlaveId;
+exports.validateSerialOptions = validateSerialOptions;
+const errors_js_1 = require("./errors.js");
+/**
+ * Check if config is a serial config (has validBaudRates)
+ */
+function isSerialConfig(config) {
+    return (config !== null &&
+        config !== undefined &&
+        typeof config === 'object' &&
+        'validBaudRates' in config);
+}
+/**
+ * Validate baud rate against driver constraints
+ *
+ * @param baudRate - User-specified baud rate
+ * @param driverMetadata - Loaded driver metadata
+ * @throws ValidationError if invalid
+ */
+function validateBaudRate(baudRate, driverMetadata) {
+    if (baudRate === undefined) {
+        return; // No validation needed if not specified
+    }
+    const supportedConfig = driverMetadata?.supportedConfig;
+    if (!isSerialConfig(supportedConfig) || !supportedConfig.validBaudRates) {
+        return; // No driver-specific constraints
+    }
+    const validRates = supportedConfig.validBaudRates;
+    if (!validRates.includes(baudRate)) {
+        const rateList = validRates.join(', ');
+        const defaultConfig = driverMetadata?.defaultConfig;
+        const defaultRate = defaultConfig && 'baudRate' in defaultConfig ? defaultConfig.baudRate : undefined;
+        throw new errors_js_1.ValidationError(`Invalid baud rate ${baudRate}. This driver supports: ${rateList}${defaultRate ? ` (default: ${defaultRate})` : ''}`, 'baudRate', baudRate, validRates);
+    }
+}
+/**
+ * Validate parity against driver constraints
+ *
+ * @param parity - User-specified parity
+ * @param driverMetadata - Loaded driver metadata
+ * @throws ValidationError if invalid
+ */
+function validateParity(parity, driverMetadata) {
+    if (parity === undefined) {
+        return;
+    }
+    const supportedConfig = driverMetadata?.supportedConfig;
+    if (!isSerialConfig(supportedConfig) || !supportedConfig.validParity) {
+        return;
+    }
+    const validParity = supportedConfig.validParity;
+    if (!validParity.includes(parity)) {
+        const parityList = validParity.join(', ');
+        const defaultConfig = driverMetadata?.defaultConfig;
+        const defaultParity = defaultConfig && 'parity' in defaultConfig ? defaultConfig.parity : undefined;
+        throw new errors_js_1.ValidationError(`Invalid parity '${parity}'. This driver supports: ${parityList}${defaultParity ? ` (default: ${defaultParity})` : ''}`, 'parity', parity, validParity);
+    }
+}
+/**
+ * Validate data bits against driver constraints
+ *
+ * @param dataBits - User-specified data bits
+ * @param driverMetadata - Loaded driver metadata
+ * @throws ValidationError if invalid
+ */
+function validateDataBits(dataBits, driverMetadata) {
+    if (dataBits === undefined) {
+        return;
+    }
+    const supportedConfig = driverMetadata?.supportedConfig;
+    if (!isSerialConfig(supportedConfig) || !supportedConfig.validDataBits) {
+        return;
+    }
+    const validDataBits = supportedConfig.validDataBits;
+    if (!validDataBits.includes(dataBits)) {
+        const bitsList = validDataBits.join(', ');
+        const defaultConfig = driverMetadata?.defaultConfig;
+        const defaultBits = defaultConfig && 'dataBits' in defaultConfig ? defaultConfig.dataBits : undefined;
+        throw new errors_js_1.ValidationError(`Invalid data bits ${dataBits}. This driver supports: ${bitsList}${defaultBits ? ` (default: ${defaultBits})` : ''}`, 'dataBits', dataBits, validDataBits);
+    }
+}
+/**
+ * Validate stop bits against driver constraints
+ *
+ * @param stopBits - User-specified stop bits
+ * @param driverMetadata - Loaded driver metadata
+ * @throws ValidationError if invalid
+ */
+function validateStopBits(stopBits, driverMetadata) {
+    if (stopBits === undefined) {
+        return;
+    }
+    const supportedConfig = driverMetadata?.supportedConfig;
+    if (!isSerialConfig(supportedConfig) || !supportedConfig.validStopBits) {
+        return;
+    }
+    const validStopBits = supportedConfig.validStopBits;
+    if (!validStopBits.includes(stopBits)) {
+        const bitsList = validStopBits.join(', ');
+        const defaultConfig = driverMetadata?.defaultConfig;
+        const defaultBits = defaultConfig && 'stopBits' in defaultConfig ? defaultConfig.stopBits : undefined;
+        throw new errors_js_1.ValidationError(`Invalid stop bits ${stopBits}. This driver supports: ${bitsList}${defaultBits ? ` (default: ${defaultBits})` : ''}`, 'stopBits', stopBits, validStopBits);
+    }
+}
+/**
+ * Validate slave ID/address against driver constraints
+ *
+ * @param slaveId - User-specified slave ID
+ * @param driverMetadata - Loaded driver metadata
+ * @throws ValidationError if invalid
+ */
+function validateSlaveId(slaveId, driverMetadata) {
+    if (slaveId === undefined) {
+        return;
+    }
+    const supportedConfig = driverMetadata?.supportedConfig;
+    if (!isSerialConfig(supportedConfig) || !supportedConfig.validAddressRange) {
+        return;
+    }
+    const [min, max] = supportedConfig.validAddressRange;
+    if (slaveId < min || slaveId > max) {
+        const defaultConfig = driverMetadata?.defaultConfig;
+        const defaultAddress = defaultConfig && 'defaultAddress' in defaultConfig ? defaultConfig.defaultAddress : undefined;
+        throw new errors_js_1.ValidationError(`Invalid slave ID ${slaveId}. This driver supports: ${min}-${max}${defaultAddress ? ` (default: ${defaultAddress})` : ''}`, 'slaveId', slaveId, [min, max]);
+    }
+}
+/**
+ * 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
+ */
+function validateSerialOptions(options, driverMetadata) {
+    validateBaudRate(options.baudRate, driverMetadata);
+    validateParity(options.parity, driverMetadata);
+    validateDataBits(options.dataBits, driverMetadata);
+    validateStopBits(options.stopBits, driverMetadata);
+    validateSlaveId(options.slaveId, driverMetadata);
+}
+//# sourceMappingURL=serial-validation.js.map

package/dist/cjs/src/serial-validation.js.map

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