@ya-modbus/driver-loader 0.6.0 → 0.7.0

package/dist/esm/errors.js

@@ -0,0 +1,81 @@
+/**
+ * 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 class ValidationError extends Error {
+    constructor(message, field) {
+        super(message);
+        this.field = field;
+        this.name = 'ValidationError';
+        Object.setPrototypeOf(this, ValidationError.prototype);
+    }
+}
+/**
+ * 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 class DriverNotFoundError extends Error {
+    constructor(message, packageName) {
+        super(message);
+        this.packageName = packageName;
+        this.name = 'DriverNotFoundError';
+        Object.setPrototypeOf(this, DriverNotFoundError.prototype);
+    }
+}
+/**
+ * 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 class PackageJsonError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'PackageJsonError';
+        Object.setPrototypeOf(this, PackageJsonError.prototype);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/esm/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,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;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,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;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,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"}

package/dist/esm/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/esm/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/esm/index.js

@@ -0,0 +1,4 @@
+export { loadDriver, clearDriverCache, getDriverCacheStats } from './loader.js';
+export { validateDefaultConfig, validateSupportedConfig, validateDevices, crossValidateConfigs, } from './config-validator.js';
+export { ValidationError, DriverNotFoundError, PackageJsonError } from './errors.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAQ/E,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/esm/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/esm/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"}

package/dist/esm/loader.js

@@ -0,0 +1,204 @@
+import { readFile } from 'fs/promises';
+import { join } from 'path';
+import { crossValidateConfigs, outputConfigWarnings, validateDefaultConfig, validateDevices, validateSupportedConfig, } from './config-validator.js';
+import { DriverNotFoundError, PackageJsonError, ValidationError } from './errors.js';
+/**
+ * Default system dependencies using Node.js built-ins
+ */
+/* istanbul ignore next */
+const defaultDeps = {
+    /* istanbul ignore next */
+    readFile: (path, encoding) => readFile(path, encoding),
+    /* istanbul ignore next */
+    importModule: (modulePath) => import(modulePath),
+    /* istanbul ignore next */
+    getCwd: () => process.cwd(),
+};
+/**
+ * LRU cache for loaded drivers
+ */
+const driverCache = new Map();
+/**
+ * Cache statistics
+ */
+const cacheStats = {
+    hits: 0,
+    misses: 0,
+};
+/**
+ * Clear the driver cache
+ * Useful for testing or when you need to reload drivers
+ */
+export function clearDriverCache() {
+    driverCache.clear();
+    cacheStats.hits = 0;
+    cacheStats.misses = 0;
+}
+/**
+ * Get cache statistics
+ * @returns Current cache statistics including hits, misses, and size
+ */
+export function getDriverCacheStats() {
+    return {
+        hits: cacheStats.hits,
+        misses: cacheStats.misses,
+        size: driverCache.size,
+    };
+}
+/**
+ * Auto-detect local driver package from package.json
+ *
+ * @param deps - System dependencies
+ * @returns Package name if valid driver package
+ * @throws Error if not a valid driver package
+ */
+async function detectLocalPackage(deps) {
+    try {
+        const packageJsonPath = join(deps.getCwd(), 'package.json');
+        const packageJsonContent = await deps.readFile(packageJsonPath, 'utf-8');
+        const packageJson = JSON.parse(packageJsonContent);
+        const keywords = packageJson.keywords ?? [];
+        if (!keywords.includes('ya-modbus-driver')) {
+            throw new PackageJsonError('Current package is not a ya-modbus driver. ' +
+                'Add "ya-modbus-driver" to keywords in package.json');
+        }
+        const name = packageJson.name;
+        if (!name) {
+            throw new PackageJsonError('package.json must have a "name" field');
+        }
+        return name;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            throw new PackageJsonError('package.json not found in current directory. ' +
+                'Run this command from a driver package directory or specify --driver');
+        }
+        if (error instanceof SyntaxError) {
+            throw new PackageJsonError('Failed to parse package.json: invalid JSON');
+        }
+        throw error;
+    }
+}
+/**
+ * Try to import a module with multiple path attempts
+ *
+ * @param paths - Array of module paths to try
+ * @param deps - System dependencies
+ * @returns Imported module
+ * @throws Error if all paths fail
+ */
+async function tryImport(paths, deps) {
+    const errors = [];
+    for (const path of paths) {
+        try {
+            return await deps.importModule(path);
+        }
+        catch (error) {
+            errors.push(error);
+        }
+    }
+    const lastError = errors[errors.length - 1];
+    throw new Error(`Failed to import module from any path. Tried: ${paths.join(', ')}\nLast error: ${lastError?.message}`, { cause: lastError });
+}
+/**
+ * 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 async function loadDriver(options = {}, deps = defaultDeps) {
+    const { driverPackage, logger = console } = options;
+    try {
+        let packageName;
+        let driverModule;
+        if (driverPackage) {
+            packageName = driverPackage;
+            const cached = driverCache.get(packageName);
+            if (cached) {
+                cacheStats.hits++;
+                return cached;
+            }
+            cacheStats.misses++;
+            try {
+                driverModule = await deps.importModule(driverPackage);
+            }
+            catch {
+                throw new DriverNotFoundError(`Driver package not found: ${driverPackage}\nInstall it with: npm install ${driverPackage}`, driverPackage);
+            }
+        }
+        else {
+            packageName = await detectLocalPackage(deps);
+            const cached = driverCache.get(packageName);
+            if (cached) {
+                cacheStats.hits++;
+                return cached;
+            }
+            cacheStats.misses++;
+            const cwd = deps.getCwd();
+            const importPaths = [
+                join(cwd, 'src', 'index.js'),
+                join(cwd, 'src', 'index.ts'),
+                join(cwd, 'dist', 'index.js'),
+                packageName,
+            ];
+            driverModule = await tryImport(importPaths, deps);
+        }
+        if (!driverModule || typeof driverModule !== 'object') {
+            throw new ValidationError('Driver package must export a createDriver function', 'createDriver');
+        }
+        const { createDriver, DEVICES, DEFAULT_CONFIG, SUPPORTED_CONFIG } = driverModule;
+        if (!createDriver) {
+            throw new ValidationError('Driver package must export a createDriver function', 'createDriver');
+        }
+        if (typeof createDriver !== 'function') {
+            throw new ValidationError('Driver package must export a createDriver function', 'createDriver');
+        }
+        const result = {
+            createDriver: createDriver,
+        };
+        if (DEVICES !== null && DEVICES !== undefined) {
+            result.devices = validateDevices(DEVICES, logger);
+        }
+        if (DEFAULT_CONFIG !== null && DEFAULT_CONFIG !== undefined) {
+            result.defaultConfig = validateDefaultConfig(DEFAULT_CONFIG);
+        }
+        if (SUPPORTED_CONFIG !== null && SUPPORTED_CONFIG !== undefined) {
+            result.supportedConfig = validateSupportedConfig(SUPPORTED_CONFIG);
+        }
+        if (result.defaultConfig && result.supportedConfig) {
+            const warnings = crossValidateConfigs(result.defaultConfig, result.supportedConfig);
+            if (warnings.length > 0) {
+                outputConfigWarnings('Driver DEFAULT_CONFIG', warnings, logger);
+            }
+        }
+        driverCache.set(packageName, result);
+        return result;
+    }
+    catch (error) {
+        if (error instanceof ValidationError ||
+            error instanceof DriverNotFoundError ||
+            error instanceof PackageJsonError) {
+            throw error;
+        }
+        if (error instanceof Error) {
+            throw new Error(`Failed to load driver: ${error.message}`, { cause: error });
+        }
+        throw new Error('Failed to load driver: Unknown error');
+    }
+}
+//# sourceMappingURL=loader.js.map

package/dist/esm/loader.js.map

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

package/dist/esm/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/dist/esm/testing/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Test utilities for @ya-modbus/driver-loader
+ *
+ * Import from '@ya-modbus/driver-loader/testing' in your tests
+ *
+ * @example
+ * ```typescript
+ * import { createMockDriver, mockSystemDeps } from '@ya-modbus/driver-loader/testing'
+ *
+ * const mockDriver = createMockDriver({
+ *   defaultConfig: { baudRate: 9600 }
+ * })
+ *
+ * const deps = mockSystemDeps({
+ *   importModule: jest.fn().mockResolvedValue(mockDriver)
+ * })
+ * ```
+ */
+export { createMockDriver, mockSystemDeps } from '../testing.js';
+export type { MockDriverOptions, MockSystemDepsOptions } from '../testing.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/testing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAChE,YAAY,EAAE,iBAAiB,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA"}

package/dist/esm/testing/index.js

@@ -0,0 +1,20 @@
+/**
+ * Test utilities for @ya-modbus/driver-loader
+ *
+ * Import from '@ya-modbus/driver-loader/testing' in your tests
+ *
+ * @example
+ * ```typescript
+ * import { createMockDriver, mockSystemDeps } from '@ya-modbus/driver-loader/testing'
+ *
+ * const mockDriver = createMockDriver({
+ *   defaultConfig: { baudRate: 9600 }
+ * })
+ *
+ * const deps = mockSystemDeps({
+ *   importModule: jest.fn().mockResolvedValue(mockDriver)
+ * })
+ * ```
+ */
+export { createMockDriver, mockSystemDeps } from '../testing.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/testing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA"}

package/dist/esm/testing.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Test utilities for driver-loader
+ *
+ * Provides mock drivers and system dependencies for testing applications
+ * that use driver-loader.
+ */
+import type { CreateDriverFunction, DefaultConfig, DeviceRegistry, SupportedConfig } from '@ya-modbus/driver-types';
+import type { LoadedDriver, SystemDependencies } from './loader.js';
+/**
+ * Options for creating a mock driver
+ */
+export interface MockDriverOptions {
+    /** Custom createDriver implementation */
+    createDriver?: CreateDriverFunction;
+    /** Mock default configuration */
+    defaultConfig?: DefaultConfig;
+    /** Mock supported configuration */
+    supportedConfig?: SupportedConfig;
+    /** Mock device registry */
+    devices?: DeviceRegistry;
+}
+/**
+ * Create a mock driver for testing
+ *
+ * @param options - Mock driver options
+ * @returns Mock driver that can be used with loadDriver
+ *
+ * @example
+ * ```typescript
+ * const mockDriver = createMockDriver({
+ *   defaultConfig: { baudRate: 9600 },
+ *   devices: { 'test': { manufacturer: 'Test', model: 'Model' } }
+ * })
+ * ```
+ */
+export declare function createMockDriver(options?: MockDriverOptions): LoadedDriver;
+/**
+ * Options for creating mock system dependencies
+ */
+export interface MockSystemDepsOptions {
+    /** Custom readFile implementation */
+    readFile?: SystemDependencies['readFile'];
+    /** Custom importModule implementation */
+    importModule?: SystemDependencies['importModule'];
+    /** Custom getCwd implementation */
+    getCwd?: SystemDependencies['getCwd'];
+}
+/**
+ * Create mock system dependencies for testing
+ *
+ * @param options - Mock system dependencies options
+ * @returns Mock SystemDependencies that can be passed to loadDriver
+ *
+ * @example
+ * ```typescript
+ * const deps = mockSystemDeps({
+ *   importModule: jest.fn().mockResolvedValue(mockDriver)
+ * })
+ *
+ * const driver = await loadDriver({ driverPackage: 'test' }, deps)
+ * ```
+ */
+export declare function mockSystemDeps(options?: MockSystemDepsOptions): SystemDependencies;
+//# sourceMappingURL=testing.d.ts.map

package/dist/esm/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../src/testing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,eAAe,EAChB,MAAM,yBAAyB,CAAA;AAEhC,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAEnE;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,YAAY,CAAC,EAAE,oBAAoB,CAAA;IACnC,iCAAiC;IACjC,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,mCAAmC;IACnC,eAAe,CAAC,EAAE,eAAe,CAAA;IACjC,2BAA2B;IAC3B,OAAO,CAAC,EAAE,cAAc,CAAA;CACzB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,YAAY,CAyB9E;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,QAAQ,CAAC,EAAE,kBAAkB,CAAC,UAAU,CAAC,CAAA;IACzC,yCAAyC;IACzC,YAAY,CAAC,EAAE,kBAAkB,CAAC,cAAc,CAAC,CAAA;IACjD,mCAAmC;IACnC,MAAM,CAAC,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAA;CACtC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,cAAc,CAAC,OAAO,GAAE,qBAA0B,GAAG,kBAAkB,CAoBtF"}

package/dist/esm/testing.js

@@ -0,0 +1,70 @@
+/**
+ * Test utilities for driver-loader
+ *
+ * Provides mock drivers and system dependencies for testing applications
+ * that use driver-loader.
+ */
+import { jest } from '@jest/globals';
+/**
+ * Create a mock driver for testing
+ *
+ * @param options - Mock driver options
+ * @returns Mock driver that can be used with loadDriver
+ *
+ * @example
+ * ```typescript
+ * const mockDriver = createMockDriver({
+ *   defaultConfig: { baudRate: 9600 },
+ *   devices: { 'test': { manufacturer: 'Test', model: 'Model' } }
+ * })
+ * ```
+ */
+export function createMockDriver(options = {}) {
+    const { createDriver = jest.fn().mockReturnValue({}), defaultConfig, supportedConfig, devices, } = options;
+    const result = {
+        createDriver,
+    };
+    if (defaultConfig) {
+        result.defaultConfig = defaultConfig;
+    }
+    if (supportedConfig) {
+        result.supportedConfig = supportedConfig;
+    }
+    if (devices) {
+        result.devices = devices;
+    }
+    return result;
+}
+/**
+ * Create mock system dependencies for testing
+ *
+ * @param options - Mock system dependencies options
+ * @returns Mock SystemDependencies that can be passed to loadDriver
+ *
+ * @example
+ * ```typescript
+ * const deps = mockSystemDeps({
+ *   importModule: jest.fn().mockResolvedValue(mockDriver)
+ * })
+ *
+ * const driver = await loadDriver({ driverPackage: 'test' }, deps)
+ * ```
+ */
+export function mockSystemDeps(options = {}) {
+    const { readFile, importModule, getCwd } = options;
+    return {
+        readFile: readFile ??
+            jest
+                .fn()
+                .mockResolvedValue('{}'),
+        importModule: importModule ??
+            jest
+                .fn()
+                .mockResolvedValue(createMockDriver()),
+        getCwd: getCwd ??
+            jest
+                .fn()
+                .mockReturnValue('/mock/cwd'),
+    };
+}
+//# sourceMappingURL=testing.js.map

package/dist/esm/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../src/testing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AAwBpC;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAA6B,EAAE;IAC9D,MAAM,EACJ,YAAY,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,CAAoC,EAC/E,aAAa,EACb,eAAe,EACf,OAAO,GACR,GAAG,OAAO,CAAA;IAEX,MAAM,MAAM,GAAiB;QAC3B,YAAY;KACb,CAAA;IAED,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,CAAC,aAAa,GAAG,aAAa,CAAA;IACtC,CAAC;IAED,IAAI,eAAe,EAAE,CAAC;QACpB,MAAM,CAAC,eAAe,GAAG,eAAe,CAAA;IAC1C,CAAC;IAED,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,OAAO,GAAG,OAAO,CAAA;IAC1B,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAcD;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,cAAc,CAAC,UAAiC,EAAE;IAChE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;IAElD,OAAO;QACL,QAAQ,EACN,QAAQ;YACP,IAAI;iBACF,EAAE,EAAkC;iBACpC,iBAAiB,CAAC,IAAI,CAAoC;QAC/D,YAAY,EACV,YAAY;YACX,IAAI;iBACF,EAAE,EAAsC;iBACxC,iBAAiB,CAAC,gBAAgB,EAAE,CAAwC;QACjF,MAAM,EACJ,MAAM;YACL,IAAI;iBACF,EAAE,EAAgC;iBAClC,eAAe,CAAC,WAAW,CAAkC;KACnE,CAAA;AACH,CAAC"}