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

package/dist/loader.js

@@ -0,0 +1,242 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.clearDriverCache = clearDriverCache;
+exports.getDriverCacheStats = getDriverCacheStats;
+exports.loadDriver = loadDriver;
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+const config_validator_js_1 = require("./config-validator.js");
+const errors_js_1 = require("./errors.js");
+/**
+ * Default system dependencies using Node.js built-ins
+ */
+/* istanbul ignore next */
+const defaultDeps = {
+    /* istanbul ignore next */
+    readFile: (path, encoding) => (0, promises_1.readFile)(path, encoding),
+    /* istanbul ignore next */
+    importModule: (modulePath) => Promise.resolve(`${modulePath}`).then(s => __importStar(require(s))),
+    /* 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
+ */
+function clearDriverCache() {
+    driverCache.clear();
+    cacheStats.hits = 0;
+    cacheStats.misses = 0;
+}
+/**
+ * Get cache statistics
+ * @returns Current cache statistics including hits, misses, and size
+ */
+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 = (0, path_1.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 errors_js_1.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 errors_js_1.PackageJsonError('package.json must have a "name" field');
+        }
+        return name;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            throw new errors_js_1.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 errors_js_1.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
+ */
+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 errors_js_1.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 = [
+                (0, path_1.join)(cwd, 'src', 'index.js'),
+                (0, path_1.join)(cwd, 'src', 'index.ts'),
+                (0, path_1.join)(cwd, 'dist', 'index.js'),
+                packageName,
+            ];
+            driverModule = await tryImport(importPaths, deps);
+        }
+        if (!driverModule || typeof driverModule !== 'object') {
+            throw new errors_js_1.ValidationError('Driver package must export a createDriver function', 'createDriver');
+        }
+        const { createDriver, DEVICES, DEFAULT_CONFIG, SUPPORTED_CONFIG } = driverModule;
+        if (!createDriver) {
+            throw new errors_js_1.ValidationError('Driver package must export a createDriver function', 'createDriver');
+        }
+        if (typeof createDriver !== 'function') {
+            throw new errors_js_1.ValidationError('Driver package must export a createDriver function', 'createDriver');
+        }
+        const result = {
+            createDriver: createDriver,
+        };
+        if (DEVICES !== null && DEVICES !== undefined) {
+            result.devices = (0, config_validator_js_1.validateDevices)(DEVICES, logger);
+        }
+        if (DEFAULT_CONFIG !== null && DEFAULT_CONFIG !== undefined) {
+            result.defaultConfig = (0, config_validator_js_1.validateDefaultConfig)(DEFAULT_CONFIG);
+        }
+        if (SUPPORTED_CONFIG !== null && SUPPORTED_CONFIG !== undefined) {
+            result.supportedConfig = (0, config_validator_js_1.validateSupportedConfig)(SUPPORTED_CONFIG);
+        }
+        if (result.defaultConfig && result.supportedConfig) {
+            const warnings = (0, config_validator_js_1.crossValidateConfigs)(result.defaultConfig, result.supportedConfig);
+            if (warnings.length > 0) {
+                (0, config_validator_js_1.outputConfigWarnings)('Driver DEFAULT_CONFIG', warnings, logger);
+            }
+        }
+        driverCache.set(packageName, result);
+        return result;
+    }
+    catch (error) {
+        if (error instanceof errors_js_1.ValidationError ||
+            error instanceof errors_js_1.DriverNotFoundError ||
+            error instanceof errors_js_1.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/loader.js.map

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

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

@@ -0,0 +1,25 @@
+"use strict";
+/**
+ * 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)
+ * })
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mockSystemDeps = exports.createMockDriver = void 0;
+var testing_js_1 = require("../testing.js");
+Object.defineProperty(exports, "createMockDriver", { enumerable: true, get: function () { return testing_js_1.createMockDriver; } });
+Object.defineProperty(exports, "mockSystemDeps", { enumerable: true, get: function () { return testing_js_1.mockSystemDeps; } });
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AAEH,4CAAgE;AAAvD,8GAAA,gBAAgB,OAAA;AAAE,4GAAA,cAAc,OAAA"}

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

@@ -0,0 +1,74 @@
+"use strict";
+/**
+ * Test utilities for driver-loader
+ *
+ * Provides mock drivers and system dependencies for testing applications
+ * that use driver-loader.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createMockDriver = createMockDriver;
+exports.mockSystemDeps = mockSystemDeps;
+const globals_1 = require("@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' } }
+ * })
+ * ```
+ */
+function createMockDriver(options = {}) {
+    const { createDriver = globals_1.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)
+ * ```
+ */
+function mockSystemDeps(options = {}) {
+    const { readFile, importModule, getCwd } = options;
+    return {
+        readFile: readFile ??
+            globals_1.jest
+                .fn()
+                .mockResolvedValue('{}'),
+        importModule: importModule ??
+            globals_1.jest
+                .fn()
+                .mockResolvedValue(createMockDriver()),
+        getCwd: getCwd ??
+            globals_1.jest
+                .fn()
+                .mockReturnValue('/mock/cwd'),
+    };
+}
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAwCH,4CAyBC;AA6BD,wCAoBC;AAhHD,2CAAoC;AAwBpC;;;;;;;;;;;;;GAaG;AACH,SAAgB,gBAAgB,CAAC,UAA6B,EAAE;IAC9D,MAAM,EACJ,YAAY,GAAG,cAAI,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,SAAgB,cAAc,CAAC,UAAiC,EAAE;IAChE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,OAAO,CAAA;IAElD,OAAO;QACL,QAAQ,EACN,QAAQ;YACP,cAAI;iBACF,EAAE,EAAkC;iBACpC,iBAAiB,CAAC,IAAI,CAAoC;QAC/D,YAAY,EACV,YAAY;YACX,cAAI;iBACF,EAAE,EAAsC;iBACxC,iBAAiB,CAAC,gBAAgB,EAAE,CAAwC;QACjF,MAAM,EACJ,MAAM;YACL,cAAI;iBACF,EAAE,EAAgC;iBAClC,eAAe,CAAC,WAAW,CAAkC;KACnE,CAAA;AACH,CAAC"}

package/package.json

@@ -0,0 +1,59 @@
+{
+  "name": "@ya-modbus/driver-loader",
+  "version": "0.4.1-refactor-scope-driver-packages.0",
+  "description": "Dynamic driver loader for ya-modbus device drivers",
+  "keywords": [
+    "modbus",
+    "driver",
+    "loader"
+  ],
+  "author": "Geno Roupsky <geno@roupsky.name>",
+  "license": "GPL-3.0-or-later",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "default": "./dist/testing/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/groupsky/ya-modbus.git",
+    "directory": "packages/driver-loader"
+  },
+  "homepage": "https://github.com/groupsky/ya-modbus/tree/main/packages/driver-loader#readme",
+  "bugs": {
+    "url": "https://github.com/groupsky/ya-modbus/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc --build",
+    "clean": "rm -rf dist",
+    "test": "jest",
+    "lint": "eslint ."
+  },
+  "dependencies": {
+    "@ya-modbus/driver-types": "^0.4.1-refactor-scope-driver-packages.0"
+  },
+  "peerDependencies": {
+    "jest": ">=29.0.0"
+  },
+  "peerDependenciesMeta": {
+    "jest": {
+      "optional": true
+    }
+  },
+  "gitHead": "b55d909d67dfff46fb79951e68a2d47ac3fab267"
+}