@ya-modbus/driver-loader 0.10.0 → 0.11.0

package/CHANGELOG.md

@@ -3,6 +3,12 @@
 All notable changes to this project will be documented in this file.
 See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
 
+# [0.11.0](https://github.com/groupsky/ya-modbus/compare/@ya-modbus/driver-loader@0.10.0...@ya-modbus/driver-loader@0.11.0) (2026-10-12)
+
+### Features
+
+- **driver-loader:** load local drivers from their package.json entry point ([#581](https://github.com/groupsky/ya-modbus/issues/581)) ([177bb89](https://github.com/groupsky/ya-modbus/commit/177bb89eab449a4ed55fe7ce37695e314cfdd358)), closes [#24](https://github.com/groupsky/ya-modbus/issues/24)
+
 # [0.10.0](https://github.com/groupsky/ya-modbus/compare/@ya-modbus/driver-loader@0.9.0...@ya-modbus/driver-loader@0.10.0) (2026-10-12)
 
 ### Features

package/README.md

@@ -18,6 +18,10 @@ import { loadDriver } from '@ya-modbus/driver-loader'
 const driver = await loadDriver({})
 ```
 
+The current directory must hold a package with the `ya-modbus-driver` keyword. The loader imports the file that Node loads for `import` of that package: `exports["."]` (conditions `node`, `import`, `module-sync`, `default`), else `main`, else `index.js`. The entry must name the file with its extension, and Node's `--conditions` flag is not used.
+
+The driver must be built, and built again after each change to its source. If the entry file is missing (no `dist` directory), or it is TypeScript source that Node cannot run, `loadDriver` throws a `DriverNotBuiltError`: build the driver first (`npm run build`), or run with Node's built-in type stripping (Node 22.18+ or 24).
+
 ### Load specific driver package
 
 ```typescript
@@ -50,6 +54,7 @@ import {
   loadDriver,
   ValidationError,
   DriverNotFoundError,
+  DriverNotBuiltError,
   PackageJsonError,
 } from '@ya-modbus/driver-loader'
 
@@ -65,6 +70,8 @@ try {
       console.error(`Package not found: ${error.packageName}`)
       console.error(`Install with: npm install ${error.packageName}`)
     }
+  } else if (error instanceof DriverNotBuiltError) {
+    console.error(`${error.packageName} is not built: run npm run build`)
   } else if (error instanceof ValidationError) {
     console.error(`Validation failed for field: ${error.field}`)
     console.error(`Error: ${error.message}`)
@@ -87,8 +94,13 @@ try {
   - `cause?: unknown` - Set when the package is installed but fails to load: the original error
   - Example: Package not installed, wrong package name, syntax error in the driver
 
+- **`DriverNotBuiltError`**: Driver package is installed but not built
+  - `packageName: string` - The package that cannot be loaded
+  - `cause?: unknown` - The error Node reported
+  - Example: Missing `dist` directory, TypeScript source that Node cannot run
+
 - **`PackageJsonError`**: package.json not found or invalid
-  - Example: Missing package.json, invalid JSON, missing ya-modbus-driver keyword
+  - Example: Missing package.json, invalid JSON, missing ya-modbus-driver keyword, `exports` without an entry for `import`
 
 ### Custom Logging
 
@@ -128,7 +140,8 @@ Loads a ya-modbus driver package and validates its exports.
 
 **Throws:**
 
-- Error if driver package is not found
+- `DriverNotFoundError` if driver package is not found or fails to load
+- `DriverNotBuiltError` if the driver is not built
 - Error if driver exports are invalid
 - Error if configuration validation fails
 
@@ -303,6 +316,20 @@ If you encounter `Driver package not found` errors:
 
 If the message starts with `Failed to load driver package`, the package is installed but its code failed to load. Read the reason in the message (or `error.cause`) instead of reinstalling.
 
+### Driver Not Built
+
+If you encounter `DriverNotBuiltError` (message `Cannot load driver <name>: ...`):
+
+1. **Build the driver:**
+
+   ```bash
+   npm run build
+   ```
+
+2. **Check the entry point:** `exports["."]` (or `main`) in package.json must name the built JavaScript file with its extension, for example `./dist/esm/index.js`.
+
+3. **TypeScript source:** Node 22.18+ and 24 run `.ts` files themselves, but only outside `node_modules`, and only if the source uses erasable TypeScript syntax (no enums) and imports files with their `.ts` extension. Build the driver otherwise.
+
 ### Module Resolution Issues
 
 If TypeScript or Node.js can't find `@ya-modbus/driver-loader`:
@@ -324,7 +351,7 @@ If TypeScript or Node.js can't find `@ya-modbus/driver-loader`:
    - Check that `"types"` field isn't excluding driver-loader
 
 4. **For local driver development:**
-   - The loader tries multiple import paths: `src/index.js`, `src/index.ts`, `dist/index.js`
+   - The loader imports the entry file from `exports` or `main` in package.json
    - Build your driver before testing: `npm run build`
 
 ### Validation Failures

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

@@ -1,5 +1,6 @@
 import type { DriverPackageCandidates } from './driver-name.js';
 import type { SystemDependencies } from './loader.js';
+type ImportDeps = Pick<SystemDependencies, 'importModule'>;
 /**
  * Import the first installed package of a list of candidates
  *
@@ -10,10 +11,22 @@ import type { SystemDependencies } from './loader.js';
  * @param candidates - Package names to try, in order
  * @param deps - System dependencies
  * @returns The imported module and the name of the package it came from
+ * @throws DriverNotBuiltError if the installed package is not built
  * @throws DriverNotFoundError if no candidate is installed or the installed one fails to load
  */
-export declare function importDriverPackage(name: string, candidates: DriverPackageCandidates, deps: Pick<SystemDependencies, 'importModule'>): Promise<{
+export declare function importDriverPackage(name: string, candidates: DriverPackageCandidates, deps: ImportDeps): Promise<{
     packageName: string;
     driverModule: unknown;
 }>;
+/**
+ * Import the entry file of the driver package in the current directory
+ *
+ * @param packageName - Name from package.json
+ * @param entryPoint - Absolute path of the entry file
+ * @param deps - System dependencies
+ * @returns The imported module
+ * @throws DriverNotBuiltError if the entry file is missing or is TypeScript that Node cannot run
+ */
+export declare function importLocalDriver(packageName: string, entryPoint: string, deps: ImportDeps): Promise<unknown>;
+export {};
 //# sourceMappingURL=driver-import.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"driver-import.d.ts","sourceRoot":"","sources":["../../../src/driver-import.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAE/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAGrD;;;;;;;;;;;GAWG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,uBAAuB,EACnC,IAAI,EAAE,IAAI,CAAC,kBAAkB,EAAE,cAAc,CAAC,GAC7C,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,CAAC,CAsBzD"}
+{"version":3,"file":"driver-import.d.ts","sourceRoot":"","sources":["../../../src/driver-import.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAE/D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAGrD,KAAK,UAAU,GAAG,IAAI,CAAC,kBAAkB,EAAE,cAAc,CAAC,CAAA;AAmC1D;;;;;;;;;;;;GAYG;AACH,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,uBAAuB,EACnC,IAAI,EAAE,UAAU,GACf,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,CAAC,CA0BzD;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,OAAO,CAAC,CAWlB"}

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

@@ -1,8 +1,29 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.importDriverPackage = importDriverPackage;
+exports.importLocalDriver = importLocalDriver;
+const node_url_1 = require("node:url");
 const errors_js_1 = require("./errors.js");
 const module_errors_js_1 = require("./module-errors.js");
+const NOT_BUILT_HINTS = {
+    'missing-file': 'Drivers are loaded as built JavaScript. Build the driver first (npm run build).',
+    typescript: 'Drivers are loaded as built JavaScript. Build the driver first (npm run build), ' +
+        "or run with Node's built-in type stripping (Node 22.18+ or 24) to load TypeScript source.",
+    'typescript-unsupported': 'Drivers are loaded as built JavaScript. Build the driver first (npm run build). ' +
+        "Node's type stripping needs erasable syntax (no enums) and imports that name files with their .ts extension.",
+    'typescript-in-node-modules': 'Node does not run TypeScript from node_modules, so a package must ship built JavaScript.',
+};
+/**
+ * Error for a driver that cannot be loaded because it is not built
+ *
+ * Shows what Node reported. The "imported from" part is left out when `hideImporter` is set,
+ * because then it only names the loader.
+ */
+function createNotBuiltError(packageName, cause, notBuilt, hideImporter = false) {
+    const firstLine = cause.message.replace(/\n[\s\S]*/, '');
+    const reason = hideImporter ? firstLine.replace(/ imported from .*$/, '') : firstLine;
+    return new errors_js_1.DriverNotBuiltError(`Cannot load driver ${packageName}: ${reason}\n${NOT_BUILT_HINTS[notBuilt]}`, packageName, { cause });
+}
 /**
  * Import the first installed package of a list of candidates
  *
@@ -13,6 +34,7 @@ const module_errors_js_1 = require("./module-errors.js");
  * @param candidates - Package names to try, in order
  * @param deps - System dependencies
  * @returns The imported module and the name of the package it came from
+ * @throws DriverNotBuiltError if the installed package is not built
  * @throws DriverNotFoundError if no candidate is installed or the installed one fails to load
  */
 async function importDriverPackage(name, candidates, deps) {
@@ -21,6 +43,10 @@ async function importDriverPackage(name, candidates, deps) {
             return { packageName, driverModule: await deps.importModule(packageName) };
         }
         catch (error) {
+            const notBuilt = (0, module_errors_js_1.getNotBuiltCause)(error);
+            if (notBuilt) {
+                throw createNotBuiltError(packageName, error, notBuilt);
+            }
             if (!(0, module_errors_js_1.isMissingPackageError)(error, packageName)) {
                 const reason = error instanceof Error ? error.message : String(error);
                 throw new errors_js_1.DriverNotFoundError(`Failed to load driver package ${packageName}: ${reason}`, packageName, { cause: error });
@@ -31,4 +57,26 @@ async function importDriverPackage(name, candidates, deps) {
     const tried = candidates.length > 1 ? `\nTried: ${candidates.join(', ')}` : '';
     throw new errors_js_1.DriverNotFoundError(`Driver package not found: ${name}${tried}\nInstall it with: npm install ${preferred}`, preferred);
 }
+/**
+ * Import the entry file of the driver package in the current directory
+ *
+ * @param packageName - Name from package.json
+ * @param entryPoint - Absolute path of the entry file
+ * @param deps - System dependencies
+ * @returns The imported module
+ * @throws DriverNotBuiltError if the entry file is missing or is TypeScript that Node cannot run
+ */
+async function importLocalDriver(packageName, entryPoint, deps) {
+    try {
+        return await deps.importModule((0, node_url_1.pathToFileURL)(entryPoint).href);
+    }
+    catch (error) {
+        const notBuilt = (0, module_errors_js_1.getNotBuiltCause)(error, entryPoint);
+        if (notBuilt === undefined) {
+            throw error;
+        }
+        // The missing entry file is reported as imported by the loader, which is no help
+        throw createNotBuiltError(packageName, error, notBuilt, notBuilt === 'missing-file');
+    }
+}
 //# sourceMappingURL=driver-import.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"driver-import.js","sourceRoot":"","sources":["../../../src/driver-import.ts"],"names":[],"mappings":";;AAiBA,kDA0BC;AA1CD,2CAAiD;AAEjD,yDAA0D;AAE1D;;;;;;;;;;;GAWG;AACI,KAAK,UAAU,mBAAmB,CACvC,IAAY,EACZ,UAAmC,EACnC,IAA8C;IAE9C,KAAK,MAAM,WAAW,IAAI,UAAU,EAAE,CAAC;QACrC,IAAI,CAAC;YACH,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,CAAA;QAC5E,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,IAAA,wCAAqB,EAAC,KAAK,EAAE,WAAW,CAAC,EAAE,CAAC;gBAC/C,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBACrE,MAAM,IAAI,+BAAmB,CAC3B,iCAAiC,WAAW,KAAK,MAAM,EAAE,EACzD,WAAW,EACX,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAA;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,GAAG,UAAU,CAAA;IAC9B,MAAM,KAAK,GAAG,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAC9E,MAAM,IAAI,+BAAmB,CAC3B,6BAA6B,IAAI,GAAG,KAAK,kCAAkC,SAAS,EAAE,EACtF,SAAS,CACV,CAAA;AACH,CAAC"}
+{"version":3,"file":"driver-import.js","sourceRoot":"","sources":["../../../src/driver-import.ts"],"names":[],"mappings":"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"}

package/dist/cjs/src/entry-point.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Conditions Node uses for `import()` when it resolves package `exports`.
+ * Other runtimes use other conditions (for example `deno` or `bun`).
+ */
+export declare const IMPORT_CONDITIONS: readonly string[];
+/** The package.json fields that decide where a package is entered */
+export interface PackageEntryFields {
+    main?: unknown;
+    exports?: unknown;
+}
+/**
+ * Find the file that `import('<package>')` loads, from a package.json
+ *
+ * Uses `exports["."]` when the package has `exports`, otherwise `main`, otherwise `index.js`,
+ * like Node does. Paths are relative to the package directory.
+ *
+ * @returns The relative path, or undefined if `exports` has no entry for these conditions
+ */
+export declare function resolvePackageEntry(packageJson: PackageEntryFields, conditions?: readonly string[]): string | undefined;
+//# sourceMappingURL=entry-point.d.ts.map

package/dist/cjs/src/entry-point.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-point.d.ts","sourceRoot":"","sources":["../../../src/entry-point.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EAAiD,CAAA;AAEhG,qEAAqE;AACrE,MAAM,WAAW,kBAAkB;IACjC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAwCD;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CACjC,WAAW,EAAE,kBAAkB,EAC/B,UAAU,GAAE,SAAS,MAAM,EAAsB,GAChD,MAAM,GAAG,SAAS,CAoBpB"}

package/dist/cjs/src/entry-point.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IMPORT_CONDITIONS = void 0;
+exports.resolvePackageEntry = resolvePackageEntry;
+/**
+ * Conditions Node uses for `import()` when it resolves package `exports`.
+ * Other runtimes use other conditions (for example `deno` or `bun`).
+ */
+exports.IMPORT_CONDITIONS = ['node', 'import', 'module-sync', 'default'];
+/**
+ * Resolve a conditional `exports` target to a file path
+ *
+ * Follows the Node rules: the first key that matches a condition and leads somewhere wins.
+ * A `null` condition blocks the path, so the search stops there. In an array, a `null`
+ * result is skipped and the next item is tried.
+ */
+function resolveTarget(target, conditions) {
+    if (target === null) {
+        return null;
+    }
+    if (typeof target === 'string') {
+        return target.startsWith('./') ? target : undefined;
+    }
+    if (Array.isArray(target)) {
+        for (const item of target) {
+            const resolved = resolveTarget(item, conditions);
+            if (typeof resolved === 'string') {
+                return resolved;
+            }
+        }
+        return undefined;
+    }
+    if (typeof target === 'object') {
+        for (const [condition, value] of Object.entries(target)) {
+            const resolved = conditions.includes(condition) ? resolveTarget(value, conditions) : undefined;
+            if (resolved !== undefined) {
+                return resolved;
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Find the file that `import('<package>')` loads, from a package.json
+ *
+ * Uses `exports["."]` when the package has `exports`, otherwise `main`, otherwise `index.js`,
+ * like Node does. Paths are relative to the package directory.
+ *
+ * @returns The relative path, or undefined if `exports` has no entry for these conditions
+ */
+function resolvePackageEntry(packageJson, conditions = exports.IMPORT_CONDITIONS) {
+    // Not destructured as `exports`: in the CommonJS build that would shadow the module's own exports
+    const { main, exports: exportsField } = packageJson;
+    if (exportsField === undefined || exportsField === null) {
+        return typeof main === 'string' ? main : 'index.js';
+    }
+    // `exports` is either a map of subpaths ("." and "./x") or the target of "." itself
+    const isSubpathMap = typeof exportsField === 'object' &&
+        !Array.isArray(exportsField) &&
+        Object.keys(exportsField).some((key) => key.startsWith('.'));
+    return (resolveTarget(isSubpathMap ? exportsField['.'] : exportsField, conditions) ?? undefined);
+}
+//# sourceMappingURL=entry-point.js.map

package/dist/cjs/src/entry-point.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entry-point.js","sourceRoot":"","sources":["../../../src/entry-point.ts"],"names":[],"mappings":";;;AA0DA,kDAuBC;AAjFD;;;GAGG;AACU,QAAA,iBAAiB,GAAsB,CAAC,MAAM,EAAE,QAAQ,EAAE,aAAa,EAAE,SAAS,CAAC,CAAA;AAQhG;;;;;;GAMG;AACH,SAAS,aAAa,CAAC,MAAe,EAAE,UAA6B;IACnE,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,OAAO,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAA;IACrD,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1B,KAAK,MAAM,IAAI,IAAI,MAAmB,EAAE,CAAC;YACvC,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,EAAE,UAAU,CAAC,CAAA;YAChD,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBACjC,OAAO,QAAQ,CAAA;YACjB,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAA;IAClB,CAAC;IAED,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAC/B,KAAK,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAiC,CAAC,EAAE,CAAC;YACnF,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAA;YAC9F,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;gBAC3B,OAAO,QAAQ,CAAA;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,mBAAmB,CACjC,WAA+B,EAC/B,aAAgC,yBAAiB;IAEjD,kGAAkG;IAClG,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,WAAW,CAAA;IAEnD,IAAI,YAAY,KAAK,SAAS,IAAI,YAAY,KAAK,IAAI,EAAE,CAAC;QACxD,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAA;IACrD,CAAC;IAED,oFAAoF;IACpF,MAAM,YAAY,GAChB,OAAO,YAAY,KAAK,QAAQ;QAChC,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC;QAC5B,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAA;IAE9D,OAAO,CACL,aAAa,CACX,YAAY,CAAC,CAAC,CAAE,YAAwC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,EAC5E,UAAU,CACX,IAAI,SAAS,CACf,CAAA;AACH,CAAC"}

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

@@ -52,6 +52,29 @@ export declare class DriverNotFoundError extends Error {
     readonly packageName: string;
     constructor(message: string, packageName: string, options?: ErrorOptions);
 }
+/**
+ * Error thrown when a driver package is installed but cannot be loaded because it is not built
+ *
+ * Drivers are loaded as built JavaScript. This covers a missing entry file (for example
+ * no `dist` directory) and TypeScript source that Node cannot run.
+ *
+ * @example
+ * ```typescript
+ * import { loadDriver, DriverNotBuiltError } from '@ya-modbus/driver-loader'
+ *
+ * try {
+ *   await loadDriver({}) // Auto-detect from current directory
+ * } catch (error) {
+ *   if (error instanceof DriverNotBuiltError) {
+ *     console.error(`Build ${error.packageName} first: npm run build`)
+ *   }
+ * }
+ * ```
+ */
+export declare class DriverNotBuiltError extends Error {
+    readonly packageName: string;
+    constructor(message: string, packageName: string, options?: ErrorOptions);
+}
 /**
  * Error thrown when package.json is not found or invalid
  *

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;;;;;;;;;;;;;;;;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;;;;;;;;;;;;;;;;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"}

package/dist/cjs/src/errors.js

@@ -6,7 +6,7 @@
  * compared to string-based error detection.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PackageJsonError = exports.DriverNotFoundError = exports.ValidationError = void 0;
+exports.PackageJsonError = exports.DriverNotBuiltError = exports.DriverNotFoundError = exports.ValidationError = void 0;
 /**
  * Error thrown when driver configuration validation fails
  *
@@ -65,6 +65,34 @@ class DriverNotFoundError extends Error {
     }
 }
 exports.DriverNotFoundError = DriverNotFoundError;
+/**
+ * Error thrown when a driver package is installed but cannot be loaded because it is not built
+ *
+ * Drivers are loaded as built JavaScript. This covers a missing entry file (for example
+ * no `dist` directory) and TypeScript source that Node cannot run.
+ *
+ * @example
+ * ```typescript
+ * import { loadDriver, DriverNotBuiltError } from '@ya-modbus/driver-loader'
+ *
+ * try {
+ *   await loadDriver({}) // Auto-detect from current directory
+ * } catch (error) {
+ *   if (error instanceof DriverNotBuiltError) {
+ *     console.error(`Build ${error.packageName} first: npm run build`)
+ *   }
+ * }
+ * ```
+ */
+class DriverNotBuiltError extends Error {
+    constructor(message, packageName, options) {
+        super(message, options);
+        this.packageName = packageName;
+        this.name = 'DriverNotBuiltError';
+        Object.setPrototypeOf(this, DriverNotBuiltError.prototype);
+    }
+}
+exports.DriverNotBuiltError = DriverNotBuiltError;
 /**
  * Error thrown when package.json is not found or invalid
  *

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;;;;;;;;;;;;;;;;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;;;;;;;;;;;;;;;;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"}

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

@@ -2,7 +2,7 @@ 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 { DRIVER_PACKAGE_NAME_RULE, assertValidDriverPackageName, isValidDriverPackageName, } from './driver-package-name.js';
-export { ValidationError, DriverNotFoundError, PackageJsonError } from './errors.js';
+export { ValidationError, DriverNotFoundError, DriverNotBuiltError, PackageJsonError, } from './errors.js';
 export { getCallerPackageInfo } from './package-info.js';
 export type { PackageInfo } from './package-info.js';
 //# sourceMappingURL=index.d.ts.map

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,EAAE,eAAe,EAAE,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AACpF,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,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.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.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; } });
@@ -17,6 +17,7 @@ Object.defineProperty(exports, "isValidDriverPackageName", { enumerable: true, g
 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, "DriverNotBuiltError", { enumerable: true, get: function () { return errors_js_1.DriverNotBuiltError; } });
 Object.defineProperty(exports, "PackageJsonError", { enumerable: true, get: function () { return errors_js_1.PackageJsonError; } });
 var package_info_js_1 = require("./package-info.js");
 Object.defineProperty(exports, "getCallerPackageInfo", { enumerable: true, get: function () { return package_info_js_1.getCallerPackageInfo; } });

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,yCAAoF;AAA3E,4GAAA,eAAe,OAAA;AAAE,gHAAA,mBAAmB,OAAA;AAAE,6GAAA,gBAAgB,OAAA;AAC/D,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,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/loader.d.ts

@@ -76,7 +76,8 @@ export interface LoadDriverOptions {
  */
 export interface SystemDependencies {
     readFile: (path: string, encoding: 'utf-8') => Promise<string>;
-    importModule: (modulePath: string) => Promise<unknown>;
+    /** Import a module by package name, or by `file:` URL for the entry file of a local package */
+    importModule: (specifier: string) => Promise<unknown>;
     getCwd: () => string;
 }
 /**
@@ -107,7 +108,10 @@ export declare function getDriverCacheStats(): DriverCacheStats;
  * 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.
+ * Auto-detection checks for `ya-modbus-driver` keyword in package.json keywords and loads
+ * the entry file that `import` of the package resolves to (`exports["."]`, else `main`,
+ * else `index.js`). The driver must be built: the entry file is JavaScript, or TypeScript
+ * that Node can run itself.
  *
  * @example
  * // Auto-detect from current directory

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

@@ -1 +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;AAahC;;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;;;;;;OAMG;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,CAmHvB"}
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../../../src/loader.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,oBAAoB,EACpB,aAAa,EACb,cAAc,EACd,eAAe,EAChB,MAAM,yBAAyB,CAAA;AAmBhC;;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;;;;;;OAMG;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,+FAA+F;IAC/F,YAAY,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACrD,MAAM,EAAE,MAAM,MAAM,CAAA;CACrB;AA6BD;;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;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,UAAU,CAC9B,OAAO,GAAE,iBAAsB,EAC/B,IAAI,GAAE,kBAAgC,GACrC,OAAO,CAAC,YAAY,CAAC,CA4GvB"}

package/dist/cjs/src/loader.js

@@ -37,11 +37,23 @@ 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 driver_import_js_1 = require("./driver-import.js");
 const driver_name_js_1 = require("./driver-name.js");
 const errors_js_1 = require("./errors.js");
+const local_package_js_1 = require("./local-package.js");
+/**
+ * Native `import()`, in the CommonJS build as well
+ *
+ * The CommonJS build compiles `import()` to `require()`, which cannot load a `file:` URL.
+ * Going through `Function` keeps the native `import()`, which also loads ES modules.
+ */
+/* istanbul ignore next */
+const nativeImport = (specifier) => {
+    // eslint-disable-next-line @typescript-eslint/no-implied-eval -- keeps `import()` out of the CommonJS transform
+    const importFn = new Function('specifier', 'return import(specifier)');
+    return importFn(specifier);
+};
 /**
  * Default system dependencies using Node.js built-ins
  */
@@ -50,7 +62,7 @@ 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))),
+    importModule: (specifier) => specifier.startsWith('file:') ? nativeImport(specifier) : Promise.resolve(`${specifier}`).then(s => __importStar(require(s))),
     /* istanbul ignore next */
     getCwd: () => process.cwd(),
 };
@@ -85,61 +97,6 @@ function getDriverCacheStats() {
         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
  *
@@ -147,7 +104,10 @@ async function tryImport(paths, deps) {
  * 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.
+ * Auto-detection checks for `ya-modbus-driver` keyword in package.json keywords and loads
+ * the entry file that `import` of the package resolves to (`exports["."]`, else `main`,
+ * else `index.js`). The driver must be built: the entry file is JavaScript, or TypeScript
+ * that Node can run itself.
  *
  * @example
  * // Auto-detect from current directory
@@ -181,21 +141,15 @@ async function loadDriver(options = {}, deps = defaultDeps) {
             driverModule = imported.driverModule;
         }
         else {
-            packageName = await detectLocalPackage(deps);
+            const localPackage = await (0, local_package_js_1.detectLocalPackage)(deps);
+            packageName = localPackage.name;
             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);
+            driverModule = await (0, driver_import_js_1.importLocalDriver)(packageName, localPackage.entryPoint, deps);
         }
         if (!driverModule || typeof driverModule !== 'object') {
             throw new errors_js_1.ValidationError('Driver package must export a createDriver function', 'createDriver');
@@ -231,6 +185,7 @@ async function loadDriver(options = {}, deps = defaultDeps) {
     catch (error) {
         if (error instanceof errors_js_1.ValidationError ||
             error instanceof errors_js_1.DriverNotFoundError ||
+            error instanceof errors_js_1.DriverNotBuiltError ||
             error instanceof errors_js_1.PackageJsonError) {
             throw error;
         }