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

package/README.md

@@ -0,0 +1,167 @@
+# @ya-modbus/driver-types
+
+TypeScript type definitions for ya-modbus device drivers.
+
+## Overview
+
+This package provides TypeScript interfaces and types for developing Modbus device drivers. It contains no runtime code - only type definitions designed to be a lightweight dependency.
+
+## Installation
+
+```bash
+npm install @ya-modbus/driver-types
+```
+
+## Core Types
+
+### DeviceDriver
+
+The main interface that all device drivers must implement:
+
+```typescript
+import type { DeviceDriver } from '@ya-modbus/driver-types'
+
+const driver: DeviceDriver = {
+  name: 'my-device',
+  manufacturer: 'Acme Corp',
+  model: 'MD-100',
+  dataPoints: [...],
+
+  async readDataPoint(id: string) { ... },
+  async writeDataPoint(id: string, value: unknown) { ... },
+  async readDataPoints(ids: string[]) { ... },
+}
+```
+
+### Transport
+
+Abstraction over Modbus RTU/TCP communication:
+
+```typescript
+import type { Transport } from '@ya-modbus/driver-types'
+
+// Read holding registers
+const buffer = await transport.readHoldingRegisters(0x0000, 2)
+
+// Write single register
+await transport.writeSingleRegister(0x0100, 1234)
+```
+
+**Transport methods:**
+
+- `readHoldingRegisters(address, count)` - Read holding registers (FC 03)
+- `readInputRegisters(address, count)` - Read input registers (FC 04)
+- `readCoils(address, count)` - Read coils (FC 01)
+- `readDiscreteInputs(address, count)` - Read discrete inputs (FC 02)
+- `writeSingleRegister(address, value)` - Write single register (FC 06)
+- `writeMultipleRegisters(address, values)` - Write multiple registers (FC 16)
+- `writeSingleCoil(address, value)` - Write single coil (FC 05)
+- `writeMultipleCoils(address, values)` - Write multiple coils (FC 15)
+- `close()` - Close the transport connection
+
+### DataPoint
+
+Defines semantic data points exposed by drivers:
+
+```typescript
+import type { DataPoint } from '@ya-modbus/driver-types'
+
+const temperaturePoint: DataPoint = {
+  id: 'temperature',
+  name: 'Temperature',
+  description: 'Current temperature reading',
+  unit: '°C',
+  dataType: 'float',
+  access: 'read',
+}
+```
+
+### Configuration Types
+
+Types for driver configuration and device defaults:
+
+```typescript
+import type {
+  DriverConfig,
+  DefaultSerialConfig,
+  DefaultTCPConfig,
+  SupportedSerialConfig,
+} from '@ya-modbus/driver-types'
+
+// Factory function configuration
+const config: DriverConfig = {
+  transport,
+  slaveId: 1,
+  device: 'or-we-514', // For multi-device drivers
+}
+
+// Default serial port configuration
+export const DEFAULT_CONFIG = {
+  baudRate: 9600,
+  parity: 'even',
+  dataBits: 8,
+  stopBits: 1,
+  defaultAddress: 1,
+} as const satisfies DefaultSerialConfig
+
+// Supported configuration constraints
+export const SUPPORTED_CONFIG = {
+  validBaudRates: [9600, 14400, 19200],
+  validParity: ['even', 'none'],
+} as const satisfies SupportedSerialConfig
+```
+
+### Multi-Device Support
+
+Types for drivers that support multiple device models:
+
+```typescript
+import type { DeviceRegistry, DeviceInfo } from '@ya-modbus/driver-types'
+
+export const DEVICES = {
+  'or-we-514': {
+    manufacturer: 'ORNO',
+    model: 'OR-WE-514',
+    description: 'Single-phase energy meter',
+  },
+  'or-we-516': {
+    manufacturer: 'ORNO',
+    model: 'OR-WE-516',
+    description: 'Three-phase energy meter',
+  },
+} as const satisfies DeviceRegistry
+```
+
+## Exported Types
+
+| Type                    | Description                      |
+| ----------------------- | -------------------------------- |
+| `DeviceDriver`          | Main driver interface            |
+| `CreateDriverFunction`  | Factory function signature       |
+| `DriverConfig`          | Factory function configuration   |
+| `Transport`             | Modbus transport interface       |
+| `DataPoint`             | Semantic data point definition   |
+| `DataType`              | Supported data types             |
+| `AccessMode`            | Read/write access modes          |
+| `Unit`                  | Standard measurement units       |
+| `SlaveId`               | Modbus slave ID (1-247)          |
+| `Parity`                | Serial parity settings           |
+| `DataBits`              | Serial data bits (7/8)           |
+| `StopBits`              | Serial stop bits (1/2)           |
+| `BaudRate`              | Serial baud rate                 |
+| `DefaultSerialConfig`   | Default RTU configuration        |
+| `DefaultTCPConfig`      | Default TCP configuration        |
+| `SupportedSerialConfig` | Serial configuration constraints |
+| `SupportedTCPConfig`    | TCP configuration constraints    |
+| `DeviceInfo`            | Device metadata                  |
+| `DeviceRegistry`        | Multi-device registry            |
+
+## See Also
+
+- [Driver SDK](../driver-sdk/) - Runtime utilities for driver development
+- [Driver Development Guide](../../docs/DRIVER-DEVELOPMENT.md)
+- [Example Drivers](../driver-ex9em/)
+
+## License
+
+GPL-3.0-or-later

package/dist/data-types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Standard data types and data point definitions
+ */
+import type { Unit } from './units.js';
+/**
+ * Standard data types for data points
+ */
+export type DataType = 'float' | 'integer' | 'boolean' | 'string' | 'timestamp' | 'enum';
+/**
+ * Polling type for data points
+ */
+export type PollType = 'dynamic' | 'static' | 'on-demand';
+/**
+ * Access permissions for data points
+ */
+export type AccessMode = 'r' | 'w' | 'rw';
+/**
+ * Data point definition (semantic interface)
+ */
+export interface DataPoint {
+    /** Unique identifier for this data point */
+    id: string;
+    /** Human-readable name */
+    name?: string;
+    /** Data type */
+    type: DataType;
+    /** Unit of measurement */
+    unit?: Unit;
+    /** Polling behavior */
+    pollType?: PollType;
+    /** Access permissions */
+    access?: AccessMode;
+    /** Optional description */
+    description?: string;
+    /** For enum type: valid values */
+    enumValues?: Record<string | number, string>;
+    /** Minimum valid value (for numeric types) */
+    min?: number;
+    /** Maximum valid value (for numeric types) */
+    max?: number;
+    /** Number of decimal places for display */
+    decimals?: number;
+}
+//# sourceMappingURL=data-types.d.ts.map

package/dist/data-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-types.d.ts","sourceRoot":"","sources":["../src/data-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,YAAY,CAAA;AAEtC;;GAEG;AACH,MAAM,MAAM,QAAQ,GAChB,OAAO,GACP,SAAS,GACT,SAAS,GACT,QAAQ,GACR,WAAW,GACX,MAAM,CAAA;AAEV;;GAEG;AACH,MAAM,MAAM,QAAQ,GAChB,SAAS,GACT,QAAQ,GACR,WAAW,CAAA;AAEf;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAAA;AAEzC;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,4CAA4C;IAC5C,EAAE,EAAE,MAAM,CAAA;IAEV,0BAA0B;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;IAEb,gBAAgB;IAChB,IAAI,EAAE,QAAQ,CAAA;IAEd,0BAA0B;IAC1B,IAAI,CAAC,EAAE,IAAI,CAAA;IAEX,uBAAuB;IACvB,QAAQ,CAAC,EAAE,QAAQ,CAAA;IAEnB,yBAAyB;IACzB,MAAM,CAAC,EAAE,UAAU,CAAA;IAEnB,2BAA2B;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAA;IAEpB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,MAAM,CAAC,CAAA;IAE5C,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAA;IAEZ,8CAA8C;IAC9C,GAAG,CAAC,EAAE,MAAM,CAAA;IAEZ,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB"}

package/dist/data-types.js

@@ -0,0 +1,5 @@
+/**
+ * Standard data types and data point definitions
+ */
+export {};
+//# sourceMappingURL=data-types.js.map

package/dist/data-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-types.js","sourceRoot":"","sources":["../src/data-types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/device-driver.d.ts

@@ -0,0 +1,283 @@
+/**
+ * Core device driver interface
+ */
+import type { DataPoint } from './data-types.js';
+import type { Transport } from './transport.js';
+/**
+ * Modbus slave/device ID
+ *
+ * Valid range: 1-247 (0 is broadcast, 248-255 reserved)
+ */
+export type SlaveId = number;
+/**
+ * Device driver factory function configuration
+ */
+export interface DriverConfig {
+    /** Device key from driver's DEVICES registry (for multi-device drivers) */
+    device?: string;
+    /** Modbus transport layer */
+    transport: Transport;
+    /** Modbus slave ID (1-247) */
+    slaveId: SlaveId;
+    /** Optional custom poll interval in milliseconds */
+    pollInterval?: number;
+}
+/**
+ * Device driver interface
+ *
+ * Drivers are created using factory functions that return objects
+ * implementing this interface.
+ */
+export interface DeviceDriver {
+    /** Unique device name/identifier */
+    readonly name: string;
+    /** Device manufacturer */
+    readonly manufacturer: string;
+    /** Device model identifier */
+    readonly model: string;
+    /** Available data points (semantic interface) */
+    readonly dataPoints: ReadonlyArray<DataPoint>;
+    /**
+     * Read data point value from device
+     *
+     * @param id - Data point identifier
+     * @returns Current value
+     */
+    readDataPoint(id: string): Promise<unknown>;
+    /**
+     * Write data point value to device
+     *
+     * @param id - Data point identifier
+     * @param value - Value to write
+     */
+    writeDataPoint(id: string, value: unknown): Promise<void>;
+    /**
+     * Read multiple data points atomically
+     *
+     * @param ids - Data point identifiers
+     * @returns Map of data point values
+     */
+    readDataPoints(ids: string[]): Promise<Record<string, unknown>>;
+    /**
+     * Optional device initialization
+     * Called once after driver creation
+     */
+    initialize?(): Promise<void>;
+    /**
+     * Optional cleanup
+     * Called when driver is being destroyed
+     */
+    destroy?(): Promise<void>;
+}
+/**
+ * Factory function signature for creating device drivers
+ */
+export type CreateDriverFunction = (config: DriverConfig) => Promise<DeviceDriver>;
+/**
+ * Serial port parity setting
+ */
+export type Parity = 'none' | 'even' | 'odd';
+/**
+ * Serial port data bits
+ */
+export type DataBits = 7 | 8;
+/**
+ * Serial port stop bits
+ */
+export type StopBits = 1 | 2;
+/**
+ * Serial port baud rate
+ *
+ * Common values: 2400, 4800, 9600, 14400, 19200, 38400, 57600, 115200
+ */
+export type BaudRate = number;
+/**
+ * Factory-default serial port configuration for RTU devices
+ *
+ * Driver packages should export a DEFAULT_CONFIG constant implementing this interface
+ * to provide sensible defaults for connecting to factory-default devices.
+ *
+ * @example
+ * ```typescript
+ * export const DEFAULT_CONFIG = {
+ *   baudRate: 9600,
+ *   parity: 'even',
+ *   dataBits: 8,
+ *   stopBits: 1,
+ *   defaultAddress: 1,
+ * } as const satisfies DefaultSerialConfig
+ * ```
+ */
+export interface DefaultSerialConfig {
+    /** Default baud rate (e.g., 9600, 19200) */
+    readonly baudRate: BaudRate;
+    /** Default parity setting */
+    readonly parity: Parity;
+    /** Default data bits (7 or 8) */
+    readonly dataBits: DataBits;
+    /** Default stop bits (1 or 2) */
+    readonly stopBits: StopBits;
+    /** Default Modbus slave address (1-247) */
+    readonly defaultAddress: SlaveId;
+}
+/**
+ * Factory-default TCP configuration for Modbus TCP devices
+ *
+ * @example
+ * ```typescript
+ * export const DEFAULT_CONFIG = {
+ *   defaultAddress: 1,
+ *   defaultPort: 502,
+ * } as const satisfies DefaultTCPConfig
+ * ```
+ */
+export interface DefaultTCPConfig {
+    /** Default Modbus unit ID (1-247) */
+    readonly defaultAddress: SlaveId;
+    /** Default TCP port (typically 502) */
+    readonly defaultPort: number;
+}
+/**
+ * Union type for default device configuration
+ *
+ * Drivers should export DEFAULT_CONFIG matching one of these types
+ */
+export type DefaultConfig = DefaultSerialConfig | DefaultTCPConfig;
+/**
+ * Supported serial port configuration values
+ *
+ * Serial driver packages should export a SUPPORTED_CONFIG constant implementing this interface
+ * to define device-specific serial configuration constraints.
+ *
+ * All properties are optional - only specify values that are device-specific.
+ * Omit properties if your device supports all standard Modbus values for that setting.
+ * For example, omit `validParity` if your device supports all parity options (none/even/odd).
+ *
+ * @example
+ * ```typescript
+ * import type { SupportedSerialConfig } from '@ya-modbus/driver-types'
+ *
+ * export const SUPPORTED_CONFIG = {
+ *   validBaudRates: [9600, 14400, 19200],
+ *   validParity: ['even', 'none'],
+ *   validDataBits: [8],
+ *   validStopBits: [1],
+ *   validAddressRange: [1, 247],
+ * } as const satisfies SupportedSerialConfig
+ * ```
+ */
+export interface SupportedSerialConfig {
+    /**
+     * Supported baud rates
+     * Common values: 2400, 4800, 9600, 14400, 19200, 38400, 57600, 115200
+     */
+    readonly validBaudRates?: readonly BaudRate[];
+    /**
+     * Supported parity settings
+     * Values: 'none', 'even', 'odd'
+     */
+    readonly validParity?: readonly Parity[];
+    /**
+     * Supported data bits
+     * Common values: 7, 8
+     */
+    readonly validDataBits?: readonly DataBits[];
+    /**
+     * Supported stop bits
+     * Common values: 1, 2
+     */
+    readonly validStopBits?: readonly StopBits[];
+    /**
+     * Supported slave address range
+     * Typically 1-247 for Modbus
+     */
+    readonly validAddressRange?: readonly [min: number, max: number];
+}
+/**
+ * Supported TCP configuration values
+ *
+ * TCP driver packages should export a SUPPORTED_CONFIG constant implementing this interface
+ * to define device-specific TCP configuration constraints.
+ *
+ * @example
+ * ```typescript
+ * import type { SupportedTCPConfig } from '@ya-modbus/driver-types'
+ *
+ * export const SUPPORTED_CONFIG = {
+ *   validPorts: [502, 503],
+ *   validAddressRange: [1, 247],
+ * } as const satisfies SupportedTCPConfig
+ * ```
+ */
+export interface SupportedTCPConfig {
+    /**
+     * Supported TCP ports
+     * Typically [502] for standard Modbus TCP
+     */
+    readonly validPorts?: readonly number[];
+    /**
+     * Supported device address range
+     * For Modbus TCP, this is the unit ID (typically 1-247)
+     */
+    readonly validAddressRange?: readonly [min: number, max: number];
+}
+/**
+ * Union type for supported device configuration
+ *
+ * Drivers should export SUPPORTED_CONFIG matching one of these types
+ */
+export type SupportedConfig = SupportedSerialConfig | SupportedTCPConfig;
+/**
+ * Device metadata for multi-device drivers
+ *
+ * Contains user-facing information about a supported device.
+ * Internal details like register mappings are not exposed here.
+ *
+ * @example
+ * ```typescript
+ * const deviceInfo: DeviceInfo = {
+ *   manufacturer: 'ORNO',
+ *   model: 'OR-WE-514',
+ *   description: 'Single-phase energy meter',
+ *   defaultConfig: { baudRate: 9600, parity: 'even', ... },
+ * }
+ * ```
+ */
+export interface DeviceInfo {
+    /** Device manufacturer */
+    readonly manufacturer: string;
+    /** Device model identifier */
+    readonly model: string;
+    /** Human-readable device description */
+    readonly description?: string;
+    /** Device-specific default configuration */
+    readonly defaultConfig?: DefaultConfig;
+    /** Device-specific supported configuration constraints */
+    readonly supportedConfig?: SupportedConfig;
+}
+/**
+ * Registry of supported devices for multi-device drivers
+ *
+ * Maps device keys to their metadata. Device keys are used with the
+ * `device` parameter in DriverConfig to select which device to use.
+ *
+ * **Must contain at least one device.** Empty registries are rejected at runtime.
+ *
+ * @example
+ * ```typescript
+ * export const DEVICES = {
+ *   'or-we-514': {
+ *     manufacturer: 'ORNO',
+ *     model: 'OR-WE-514',
+ *     description: 'Single-phase energy meter',
+ *   },
+ *   'or-we-516': {
+ *     manufacturer: 'ORNO',
+ *     model: 'OR-WE-516',
+ *     description: 'Three-phase energy meter',
+ *   },
+ * } as const satisfies DeviceRegistry
+ * ```
+ */
+export type DeviceRegistry = Readonly<Record<string, DeviceInfo>>;
+//# sourceMappingURL=device-driver.d.ts.map

package/dist/device-driver.d.ts.map

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

package/dist/device-driver.js

@@ -0,0 +1,5 @@
+/**
+ * Core device driver interface
+ */
+export {};
+//# sourceMappingURL=device-driver.js.map

package/dist/device-driver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-driver.js","sourceRoot":"","sources":["../src/device-driver.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Type definitions for ya-modbus device drivers
+ *
+ * This package contains TypeScript type definitions with no runtime code.
+ * It's designed to be a lightweight dependency for driver packages.
+ */
+export * from './device-driver.js';
+export * from './data-types.js';
+export * from './units.js';
+export * from './transport.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * Type definitions for ya-modbus device drivers
+ *
+ * This package contains TypeScript type definitions with no runtime code.
+ * It's designed to be a lightweight dependency for driver packages.
+ */
+// Re-export all types
+export * from './device-driver.js';
+export * from './data-types.js';
+export * from './units.js';
+export * from './transport.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,sBAAsB;AACtB,cAAc,oBAAoB,CAAA;AAClC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA"}

package/dist/transport.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Transport layer interface
+ *
+ * Abstraction over Modbus RTU/TCP transports.
+ * Drivers use this interface to communicate with devices.
+ */
+/**
+ * Modbus transport interface
+ */
+export interface Transport {
+    /**
+     * Read holding registers
+     *
+     * @param address - Starting register address
+     * @param count - Number of registers to read
+     * @returns Register values as Buffer
+     */
+    readHoldingRegisters(address: number, count: number): Promise<Buffer>;
+    /**
+     * Read input registers
+     *
+     * @param address - Starting register address
+     * @param count - Number of registers to read
+     * @returns Register values as Buffer
+     */
+    readInputRegisters(address: number, count: number): Promise<Buffer>;
+    /**
+     * Read coils
+     *
+     * @param address - Starting coil address
+     * @param count - Number of coils to read
+     * @returns Coil values as Buffer
+     */
+    readCoils(address: number, count: number): Promise<Buffer>;
+    /**
+     * Read discrete inputs
+     *
+     * @param address - Starting input address
+     * @param count - Number of inputs to read
+     * @returns Input values as Buffer
+     */
+    readDiscreteInputs(address: number, count: number): Promise<Buffer>;
+    /**
+     * Write single holding register
+     *
+     * @param address - Register address
+     * @param value - Value to write (16-bit)
+     */
+    writeSingleRegister(address: number, value: number): Promise<void>;
+    /**
+     * Write multiple holding registers
+     *
+     * @param address - Starting register address
+     * @param values - Register values as Buffer
+     */
+    writeMultipleRegisters(address: number, values: Buffer): Promise<void>;
+    /**
+     * Write single coil
+     *
+     * @param address - Coil address
+     * @param value - Value to write (boolean)
+     */
+    writeSingleCoil(address: number, value: boolean): Promise<void>;
+    /**
+     * Write multiple coils
+     *
+     * @param address - Starting coil address
+     * @param values - Coil values as Buffer
+     */
+    writeMultipleCoils(address: number, values: Buffer): Promise<void>;
+    /**
+     * Close the transport connection
+     *
+     * Releases resources and allows the process to exit.
+     * Should be called when done using the transport.
+     */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB;;;;;;OAMG;IACH,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAErE;;;;;;OAMG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAEnE;;;;;;OAMG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAE1D;;;;;;OAMG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAEnE;;;;;OAKG;IACH,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAElE;;;;;OAKG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEtE;;;;;OAKG;IACH,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAE/D;;;;;OAKG;IACH,kBAAkB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAElE;;;;;OAKG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB"}

package/dist/transport.js

@@ -0,0 +1,8 @@
+/**
+ * Transport layer interface
+ *
+ * Abstraction over Modbus RTU/TCP transports.
+ * Drivers use this interface to communicate with devices.
+ */
+export {};
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/units.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Standard units of measurement
+ *
+ * Canonical unit definitions for device data points.
+ * Drivers should use these standard units for interoperability.
+ */
+/**
+ * Standard unit types
+ */
+export type Unit = 'V' | 'A' | 'W' | 'kW' | 'VA' | 'kVA' | 'VAr' | 'kVAr' | 'Wh' | 'kWh' | 'MWh' | 'VArh' | 'kVArh' | 'Ah' | 'Hz' | 'Ω' | '°C' | '°F' | 'K' | 'Pa' | 'kPa' | 'bar' | 'psi' | 'L/s' | 'L/min' | 'm³/h' | 'm/s' | 'km/h' | 'rpm' | '%' | 's' | 'min' | 'h' | 'ppm' | 'dB';
+//# sourceMappingURL=units.d.ts.map

package/dist/units.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"units.d.ts","sourceRoot":"","sources":["../src/units.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,IAAI,GAEZ,GAAG,GACH,GAAG,GACH,GAAG,GACH,IAAI,GACJ,IAAI,GACJ,KAAK,GACL,KAAK,GACL,MAAM,GACN,IAAI,GACJ,KAAK,GACL,KAAK,GACL,MAAM,GACN,OAAO,GACP,IAAI,GACJ,IAAI,GACJ,GAAG,GAGH,IAAI,GACJ,IAAI,GACJ,GAAG,GAGH,IAAI,GACJ,KAAK,GACL,KAAK,GACL,KAAK,GAGL,KAAK,GACL,OAAO,GACP,MAAM,GAGN,KAAK,GACL,MAAM,GACN,KAAK,GAGL,GAAG,GAGH,GAAG,GACH,KAAK,GACL,GAAG,GAGH,KAAK,GACL,IAAI,CAAA"}

package/dist/units.js

@@ -0,0 +1,10 @@
+/**
+ * Standard units of measurement
+ *
+ * Canonical unit definitions for device data points.
+ * Drivers should use these standard units for interoperability.
+ */
+export {};
+// Note: For custom units not in this list, use the closest standard unit
+// or request addition to this type definition
+//# sourceMappingURL=units.js.map