@ya-modbus/mqtt-bridge 0.6.0 → 0.7.0

package/dist/esm/src/polling-scheduler.d.ts

@@ -0,0 +1,48 @@
+import type { DeviceDriver } from '@ya-modbus/driver-types';
+import type { DeviceConfig } from './types.js';
+type DataCallback = (deviceId: string, data: Record<string, unknown>) => void;
+type ErrorCallback = (deviceId: string, error: Error, failureCount: number) => void;
+/**
+ * Coordinates polling across multiple devices
+ */
+export declare class PollingScheduler {
+    private onData;
+    private onError;
+    private devices;
+    private running;
+    constructor(onData: DataCallback, onError: ErrorCallback);
+    /**
+     * Schedule a device for polling
+     */
+    scheduleDevice(deviceId: string, config: DeviceConfig, driver: DeviceDriver): void;
+    /**
+     * Stop polling a device and remove it from the schedule
+     */
+    unscheduleDevice(deviceId: string): void;
+    /**
+     * Start polling all scheduled devices
+     */
+    start(): void;
+    /**
+     * Stop polling all devices
+     */
+    stop(): void;
+    /**
+     * Check if a device is scheduled for polling
+     */
+    isScheduled(deviceId: string): boolean;
+    /**
+     * Start polling for a specific device
+     */
+    private startDevicePolling;
+    /**
+     * Schedule the next poll for a device, with backoff if needed
+     */
+    private scheduleNextPoll;
+    /**
+     * Poll a device once
+     */
+    private pollDevice;
+}
+export {};
+//# sourceMappingURL=polling-scheduler.d.ts.map

package/dist/esm/src/polling-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"polling-scheduler.d.ts","sourceRoot":"","sources":["../../../src/polling-scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAE3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAU9C,KAAK,YAAY,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAA;AAC7E,KAAK,aAAa,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,KAAK,IAAI,CAAA;AAInF;;GAEG;AACH,qBAAa,gBAAgB;IAKzB,OAAO,CAAC,MAAM;IACd,OAAO,CAAC,OAAO;IALjB,OAAO,CAAC,OAAO,CAAqC;IACpD,OAAO,CAAC,OAAO,CAAQ;gBAGb,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,aAAa;IAGhC;;OAEG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI;IAelF;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAQxC;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,IAAI,IAAI,IAAI;IAWZ;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAItC;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAQ1B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;OAEG;YACW,UAAU;CAyCzB"}

package/dist/{src → esm/src}/polling-scheduler.js

@@ -3,13 +3,11 @@ const DEFAULT_POLLING_INTERVAL = 5000; // 5 seconds
  * Coordinates polling across multiple devices
  */
 export class PollingScheduler {
-    onData;
-    onError;
-    devices = new Map();
-    running = false;
     constructor(onData, onError) {
         this.onData = onData;
         this.onError = onError;
+        this.devices = new Map();
+        this.running = false;
     }
     /**
      * Schedule a device for polling

package/dist/esm/src/polling-scheduler.js.map

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

package/dist/esm/src/types.d.ts

@@ -0,0 +1,86 @@
+export interface MqttBridgeConfig {
+    mqtt: {
+        url: string;
+        clientId?: string;
+        username?: string;
+        password?: string;
+        reconnectPeriod?: number;
+    };
+    stateDir?: string;
+    topicPrefix?: string;
+}
+export interface BridgeStatus {
+    state: 'starting' | 'running' | 'stopping' | 'stopped' | 'error';
+    timestamp: number;
+    deviceCount: number;
+    mqttConnected?: boolean;
+    errors?: string[];
+}
+export interface PublishOptions {
+    qos?: 0 | 1 | 2;
+    retain?: boolean;
+}
+export interface SubscribeOptions {
+    qos?: 0 | 1 | 2;
+}
+export interface MqttMessage {
+    topic: string;
+    payload: Buffer;
+    qos: 0 | 1 | 2;
+    retain: boolean;
+}
+export type MessageHandler = (message: MqttMessage) => void;
+export interface PollingConfig {
+    interval: number;
+    maxRetries?: number;
+    retryBackoff?: number;
+}
+export interface DeviceConfig {
+    deviceId: string;
+    driver: string;
+    connection: DeviceConnection;
+    enabled?: boolean;
+    polling?: PollingConfig;
+}
+export type DeviceConnection = RTUConnection | TCPConnection;
+export interface RTUConnection {
+    type: 'rtu';
+    port: string;
+    baudRate: number;
+    slaveId: number;
+    parity: 'none' | 'even' | 'odd';
+    dataBits: 7 | 8;
+    stopBits: 1 | 2;
+    timeout?: number;
+}
+export interface TCPConnection {
+    type: 'tcp';
+    host: string;
+    port?: number;
+    slaveId: number;
+    timeout?: number;
+}
+export interface DeviceStatus {
+    deviceId: string;
+    state: 'connecting' | 'connected' | 'disconnected' | 'error';
+    enabled: boolean;
+    connected: boolean;
+    lastUpdate?: number;
+    lastPoll?: number;
+    consecutiveFailures?: number;
+    errors?: string[];
+}
+export interface MqttBridge {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getStatus(): BridgeStatus;
+    publish(topic: string, payload: string | Buffer, options?: PublishOptions): Promise<void>;
+    subscribe(topic: string, handler: MessageHandler, options?: SubscribeOptions): Promise<void>;
+    unsubscribe(topic: string): Promise<void>;
+    addDevice(config: DeviceConfig): Promise<void>;
+    removeDevice(deviceId: string): Promise<void>;
+    getDevice(deviceId: string): DeviceStatus | undefined;
+    listDevices(): DeviceStatus[];
+    getDeviceConfig(deviceId: string): DeviceConfig | undefined;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/esm/src/types.d.ts.map

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

package/dist/esm/src/types.js.map

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

package/dist/esm/src/utils/config-validator.d.ts

@@ -0,0 +1,3 @@
+import type { MqttBridgeConfig } from '../types.js';
+export declare function validateConfig(config: unknown): asserts config is MqttBridgeConfig;
+//# sourceMappingURL=config-validator.d.ts.map

package/dist/esm/src/utils/config-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-validator.d.ts","sourceRoot":"","sources":["../../../../src/utils/config-validator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AA4BnD,wBAAgB,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,IAAI,gBAAgB,CAOlF"}

package/dist/esm/src/utils/config-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-validator.js","sourceRoot":"","sources":["../../../../src/utils/config-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,EAAE;SACL,KAAK,CAAC,2BAA2B,EAAE;QAClC,OAAO,EAAE,yDAAyD;KACnE,CAAC;IACJ,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACxD,CAAC,CAAA;AAEF,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,gBAAgB;IACtB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;QACT,4CAA4C;SAC3C,KAAK,CAAC,gBAAgB,EAAE;QACvB,OAAO,EACL,sFAAsF;KACzF,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAA;AAEF,MAAM,UAAU,cAAc,CAAC,MAAe;IAC5C,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;IAEvD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7F,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,EAAE,CAAC,CAAA;IACrD,CAAC;AACH,CAAC"}

package/dist/esm/src/utils/config.d.ts

@@ -0,0 +1,3 @@
+import type { MqttBridgeConfig } from '../types.js';
+export declare function loadConfig(configPath: string): Promise<MqttBridgeConfig>;
+//# sourceMappingURL=config.d.ts.map

package/dist/esm/src/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../../src/utils/config.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AA6BnD,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4B9E"}

package/dist/esm/src/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAE3C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAIvB,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChC,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,EAAE;SACL,KAAK,CAAC,2BAA2B,EAAE;QAClC,OAAO,EAAE,yDAAyD;KACnE,CAAC;SACD,OAAO,CAAC,uBAAuB,CAAC;IACnC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CACxD,CAAC,CAAA;AAEF,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IACtC,IAAI,EAAE,gBAAgB,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,uBAAuB,EAAE,CAAC;IAChE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;QACT,4CAA4C;SAC3C,KAAK,CAAC,gBAAgB,EAAE;QACvB,OAAO,EACL,sFAAsF;KACzF,CAAC;SACD,QAAQ,EAAE;CACd,CAAC,CAAA;AAEF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,UAAkB;IACjD,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAA;IACnD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAY,CAAA;IAE3C,qEAAqE;IACrE,MAAM,MAAM,GAAG,sBAAsB,CAAC,SAAS,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IAE1E,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC7F,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,EAAE,CAAC,CAAA;IACrD,CAAC;IAED,wEAAwE;IACxE,MAAM,MAAM,GAAqB;QAC/B,IAAI,EAAE;YACJ,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;YACzB,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvF,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvF,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvF,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,KAAK,SAAS,IAAI;gBACpD,eAAe,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe;aAClD,CAAC;SACH;QACD,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,KAAK,SAAS,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC7E,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;KACvF,CAAA;IAED,OAAO,MAAM,CAAA;AACf,CAAC"}

package/dist/esm/src/utils/device-validation.d.ts

@@ -0,0 +1,31 @@
+import { z } from 'zod';
+export declare const deviceConfigSchema: z.ZodObject<{
+    deviceId: z.ZodString;
+    driver: z.ZodString;
+    connection: z.ZodUnion<readonly [z.ZodObject<{
+        type: z.ZodLiteral<"rtu">;
+        port: z.ZodString;
+        baudRate: z.ZodNumber;
+        slaveId: z.ZodNumber;
+        parity: z.ZodOptional<z.ZodEnum<{
+            none: "none";
+            even: "even";
+            odd: "odd";
+        }>>;
+        dataBits: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<7>, z.ZodLiteral<8>]>>;
+        stopBits: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>]>>;
+    }, z.core.$strip>, z.ZodObject<{
+        type: z.ZodLiteral<"tcp">;
+        host: z.ZodString;
+        port: z.ZodNumber;
+        slaveId: z.ZodNumber;
+    }, z.core.$strip>]>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    polling: z.ZodOptional<z.ZodObject<{
+        interval: z.ZodNumber;
+        maxRetries: z.ZodOptional<z.ZodNumber>;
+        retryBackoff: z.ZodOptional<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export declare function validateDeviceConfig(config: unknown): void;
+//# sourceMappingURL=device-validation.d.ts.map

package/dist/esm/src/utils/device-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-validation.d.ts","sourceRoot":"","sources":["../../../../src/utils/device-validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AA+DvB,eAAO,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAM7B,CAAA;AAEF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAO1D"}

package/dist/esm/src/utils/device-validation.js.map

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

package/dist/esm/src/utils/package-info.d.ts

@@ -0,0 +1,5 @@
+export declare function getPackageInfo(): {
+    version: string;
+    description: string;
+};
+//# sourceMappingURL=package-info.d.ts.map

package/dist/esm/src/utils/package-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-info.d.ts","sourceRoot":"","sources":["../../../../src/utils/package-info.ts"],"names":[],"mappings":"AAIA,wBAAgB,cAAc,IAAI;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CA2BzE"}

package/dist/esm/src/utils/package-info.js

@@ -0,0 +1,27 @@
+import { readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+export function getPackageInfo() {
+    // Determine the package root differently for ESM vs CJS builds
+    // In CJS: __dirname is available
+    // In ESM: use import.meta.url
+    let pkgPath;
+    // Check if we're in a CommonJS context by testing for __dirname
+    // This works because typeof __dirname is 'undefined' in ESM but 'string' in CJS
+    if (typeof __dirname !== 'undefined') {
+        // CommonJS: file is at dist/cjs/src/utils/package-info.js
+        pkgPath = join(__dirname, '../../../../package.json');
+    }
+    else {
+        // ESM: file is at dist/esm/src/utils/package-info.js
+        // Use import.meta.url (only executed in ESM builds where it's valid)
+        // TypeScript will complain about import.meta in CJS, but this branch is never reached in CJS runtime
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore - import.meta is valid in ESM but TypeScript CJS build sees all code
+        const currentFileUrl = new URL(import.meta.url);
+        pkgPath = fileURLToPath(new URL('../../../../package.json', currentFileUrl));
+    }
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+    return pkg;
+}
+//# sourceMappingURL=package-info.js.map

package/dist/esm/src/utils/package-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-info.js","sourceRoot":"","sources":["../../../../src/utils/package-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA;AAExC,MAAM,UAAU,cAAc;IAC5B,+DAA+D;IAC/D,iCAAiC;IACjC,8BAA8B;IAE9B,IAAI,OAAe,CAAA;IAEnB,gEAAgE;IAChE,gFAAgF;IAChF,IAAI,OAAO,SAAS,KAAK,WAAW,EAAE,CAAC;QACrC,0DAA0D;QAC1D,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,0BAA0B,CAAC,CAAA;IACvD,CAAC;SAAM,CAAC;QACN,qDAAqD;QACrD,qEAAqE;QACrE,qGAAqG;QACrG,6DAA6D;QAC7D,kFAAkF;QAClF,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC/C,OAAO,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,0BAA0B,EAAE,cAAc,CAAC,CAAC,CAAA;IAC9E,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,CAGpD,CAAA;IACD,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/esm/src/utils/process.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Process utilities for signal handling and exit
+ * Extracted to separate module for testability
+ */
+export interface ProcessUtils {
+    exit(code: number): void;
+    onSignal(signal: NodeJS.Signals, handler: () => void): void;
+}
+export declare const processUtils: ProcessUtils;
+//# sourceMappingURL=process.d.ts.map

package/dist/esm/src/utils/process.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.d.ts","sourceRoot":"","sources":["../../../../src/utils/process.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAA;CAC5D;AAED,eAAO,MAAM,YAAY,EAAE,YAQ1B,CAAA"}

package/dist/esm/src/utils/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../../../../src/utils/process.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,CAAC,MAAM,YAAY,GAAiB;IACxC,IAAI,CAAC,IAAY;QACf,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACpB,CAAC;IAED,QAAQ,CAAC,MAAsB,EAAE,OAAmB;QAClD,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,CAAC;CACF,CAAA"}

package/dist/esm/src/utils/test-utils.d.ts

@@ -0,0 +1,313 @@
+import { AddressInfo, Server } from 'node:net';
+import { jest } from '@jest/globals';
+import type { Transport, DeviceDriver } from '@ya-modbus/driver-types';
+import { TransportManager } from '@ya-modbus/transport';
+import Aedes from 'aedes';
+import { DriverLoader } from '../driver-loader.js';
+import type { MessageHandler, MqttBridge, MqttBridgeConfig, PublishOptions, SubscribeOptions } from '../types.js';
+export interface TestBroker {
+    address: AddressInfo;
+    url: string;
+    port: number;
+    broker: Aedes;
+    server: Server;
+    close: () => Promise<void>;
+}
+/**
+ * Race a promise against a timeout, properly cleaning up the timer
+ *
+ * This ensures Jest can exit cleanly by clearing the timeout when the promise settles.
+ * Always use this instead of bare Promise.race with setTimeout.
+ *
+ * @param promise - The promise to race
+ * @param timeoutMs - Timeout in milliseconds
+ * @param errorMessage - Error message if timeout occurs, or a function that returns the message
+ * @returns Promise that resolves/rejects with the first settled result
+ *
+ * @example
+ * // With static message
+ * await withTimeout(
+ *   clientReadyPromise,
+ *   5000,
+ *   'Client ready timeout'
+ * )
+ *
+ * @example
+ * // With dynamic message (evaluated when timeout occurs)
+ * await withTimeout(
+ *   disconnectPromise,
+ *   5000,
+ *   () => `Still connected: ${broker.connectedClients}`
+ * )
+ */
+export declare function withTimeout<T>(promise: Promise<T>, timeoutMs: number, errorMessage: string | (() => string)): Promise<T>;
+/**
+ * Wait for all MQTT clients to disconnect from a test broker
+ *
+ * @param broker - The test broker to monitor
+ * @param timeoutMs - Maximum time to wait in milliseconds (default: 5000)
+ * @returns Promise that resolves when all clients disconnect or rejects on timeout
+ *
+ * @example
+ * await waitForAllClientsToDisconnect(broker, 5000)
+ */
+export declare function waitForAllClientsToDisconnect(broker: TestBroker, timeoutMs?: number): Promise<void>;
+/**
+ * Wait for a client to be ready
+ *
+ * @param broker - The test broker to monitor
+ * @param timeoutMs - Maximum time to wait in milliseconds (default: 2000)
+ * @returns Promise that resolves when a client is ready or rejects on timeout
+ *
+ * @example
+ * await waitForClientReady(broker)
+ */
+export declare function waitForClientReady(broker: TestBroker, timeoutMs?: number): Promise<void>;
+/**
+ * Wait for a client to disconnect
+ *
+ * @param broker - The test broker to monitor
+ * @param timeoutMs - Maximum time to wait in milliseconds (default: 2000)
+ * @returns Promise that resolves when a client disconnects or rejects on timeout
+ *
+ * @example
+ * await waitForClientDisconnect(broker)
+ */
+export declare function waitForClientDisconnect(broker: TestBroker, timeoutMs?: number): Promise<void>;
+/**
+ * Wait for a publish event on the broker
+ *
+ * @param broker - The test broker to monitor
+ * @param topicPattern - Optional topic to match (supports wildcards)
+ * @param timeoutMs - Maximum time to wait in milliseconds (default: 1000)
+ * @returns Promise that resolves with the published packet or rejects on timeout
+ *
+ * @example
+ * const packet = await waitForPublish(broker, 'test/topic')
+ */
+export declare function waitForPublish(broker: TestBroker, topicPattern?: string, timeoutMs?: number): Promise<{
+    topic: string;
+    payload: Buffer;
+}>;
+/**
+ * Wait for a subscribe event on the broker
+ *
+ * @param broker - The test broker to monitor
+ * @param topicPattern - Optional topic to match
+ * @param timeoutMs - Maximum time to wait in milliseconds (default: 1000)
+ * @returns Promise that resolves with subscriptions or rejects on timeout
+ *
+ * @example
+ * await waitForSubscribe(broker, 'test/topic')
+ */
+export declare function waitForSubscribe(broker: TestBroker, topicPattern?: string, timeoutMs?: number): Promise<Array<{
+    topic: string;
+}>>;
+/**
+ * Wait for an unsubscribe event on the broker
+ *
+ * @param broker - The test broker to monitor
+ * @param topicPattern - Optional topic to match
+ * @param timeoutMs - Maximum time to wait in milliseconds (default: 1000)
+ * @returns Promise that resolves with unsubscriptions or rejects on timeout
+ *
+ * @example
+ * await waitForUnsubscribe(broker, 'test/topic')
+ */
+export declare function waitForUnsubscribe(broker: TestBroker, topicPattern?: string, timeoutMs?: number): Promise<Array<string>>;
+/**
+ * Create a test bridge configuration with optional overrides
+ *
+ * @param broker - The test broker to connect to
+ * @param overrides - Optional configuration overrides
+ * @returns Bridge configuration for testing
+ *
+ * @example
+ * const config = createTestBridgeConfig(broker, { topicPrefix: 'custom' })
+ */
+export declare function createTestBridgeConfig(broker: TestBroker, overrides?: Partial<MqttBridgeConfig>): MqttBridgeConfig;
+/**
+ * Subscribe to a topic and wait for the subscription to be registered with the broker
+ *
+ * @param bridge - The MQTT bridge instance
+ * @param broker - The test broker to monitor
+ * @param topic - Topic to subscribe to (without prefix)
+ * @param handler - Message handler function
+ * @param options - Subscribe options and topic prefix
+ * @returns Promise that resolves when subscription is registered
+ *
+ * @example
+ * await subscribeAndWait(bridge, broker, 'test/topic', (msg) => { ... })
+ */
+export declare function subscribeAndWait(bridge: MqttBridge, broker: TestBroker, topic: string, handler: MessageHandler, options?: SubscribeOptions & {
+    prefix?: string;
+}): Promise<void>;
+/**
+ * Publish a message and wait for it to be published to the broker
+ *
+ * @param bridge - The MQTT bridge instance
+ * @param broker - The test broker to monitor
+ * @param topic - Topic to publish to (without prefix)
+ * @param message - Message payload
+ * @param options - Publish options and topic prefix
+ * @returns Promise that resolves when message is published
+ *
+ * @example
+ * await publishAndWait(bridge, broker, 'test/topic', 'Hello', { qos: 1 })
+ */
+export declare function publishAndWait(bridge: MqttBridge, broker: TestBroker, topic: string, message: string | Buffer, options?: PublishOptions & {
+    prefix?: string;
+}): Promise<void>;
+/**
+ * Message collector for capturing messages in tests
+ */
+export interface MessageCollector {
+    messages: string[];
+    handler: MessageHandler;
+    clear: () => void;
+}
+/**
+ * Create a message collector for capturing messages in tests
+ *
+ * @returns Message collector with handler and utilities
+ *
+ * @example
+ * const collector = createMessageCollector()
+ * await bridge.subscribe('test/topic', collector.handler)
+ * expect(collector.messages).toContain('Expected message')
+ */
+export declare function createMessageCollector(): MessageCollector;
+/**
+ * Execute a test function with a running bridge, ensuring proper cleanup
+ *
+ * Automatically starts the bridge before the test and stops it after,
+ * even if the test throws an error. This eliminates boilerplate and
+ * ensures resources are properly cleaned up.
+ *
+ * @param config - Bridge configuration
+ * @param testFn - Test function to execute with the running bridge (can be sync or async)
+ * @returns Promise that resolves when test completes and bridge is stopped
+ *
+ * @example
+ * await withBridge(createTestBridgeConfig(broker), async (bridge) => {
+ *   const status = bridge.getStatus()
+ *   expect(status.state).toBe('running')
+ * })
+ */
+export declare function withBridge(config: MqttBridgeConfig, testFn: (bridge: MqttBridge) => Promise<void> | void): Promise<void>;
+/**
+ * Execute a test function with a running bridge using mock driver DI
+ *
+ * Automatically sets up the bridge with injected mocks, starts it before the test,
+ * and stops it after. This eliminates boilerplate for tests that need to verify
+ * driver lifecycle with dependency injection.
+ *
+ * @param broker - The test broker to connect to
+ * @param testFn - Test function with bridge and mocks
+ * @param overrides - Optional configuration overrides
+ * @returns Promise that resolves when test completes and bridge is stopped
+ *
+ * @example
+ * await withBridgeAndMockDriver(broker, async (bridge, mocks) => {
+ *   await bridge.addDevice({ deviceId: 'test', driver: 'mock', connection: {...} })
+ *   expect(mocks.mockDriver.initialize).toHaveBeenCalled()
+ * })
+ */
+export declare function withBridgeAndMockDriver(broker: TestBroker, testFn: (bridge: MqttBridge, mocks: {
+    mockDriver: jest.Mocked<DeviceDriver>;
+    mockTransport: jest.Mocked<Transport>;
+    mockLoadDriverFn: jest.Mock;
+    mockTransportManager: jest.Mocked<TransportManager>;
+}) => Promise<void> | void, overrides?: Partial<MqttBridgeConfig>): Promise<void>;
+/**
+ * Start an Aedes MQTT broker on a dynamic port for testing
+ */
+export declare function startTestBroker(options?: {
+    port?: number;
+}): Promise<TestBroker>;
+/**
+ * Create a mock transport for testing
+ *
+ * Returns a transport mock that implements the Transport interface
+ * with jest.fn() for all methods, allowing verification of calls.
+ *
+ * @returns Mock transport with trackable method calls
+ *
+ * @example
+ * const mockTransport = createMockTransport()
+ * mockTransport.readHoldingRegisters.mockResolvedValue([1, 2, 3])
+ */
+export declare function createMockTransport(): jest.Mocked<Transport>;
+/**
+ * Create a mock TransportManager for testing
+ *
+ * Returns a TransportManager mock that implements the TransportManager interface
+ * with jest.fn() for all methods, allowing verification of calls.
+ *
+ * @returns Mock TransportManager with trackable method calls
+ *
+ * @example
+ * const mockTransportManager = createMockTransportManager()
+ * const loader = new DriverLoader(mockLoadDriver, mockTransportManager)
+ */
+export declare function createMockTransportManager(): jest.Mocked<TransportManager>;
+/**
+ * Create a mock driver for testing
+ *
+ * Returns a mock driver that implements the DeviceDriver interface
+ * with jest.fn() for all methods, allowing verification of calls.
+ *
+ * @param overrides - Optional property overrides
+ * @returns Mock driver with trackable method calls
+ *
+ * @example
+ * const mockDriver = createMockDriver({
+ *   dataPoints: [{ id: 'voltage', name: 'Voltage', type: 'number', unit: 'V' }]
+ * })
+ * mockDriver.readDataPoints.mockResolvedValue({ voltage: 230 })
+ */
+export declare function createMockDriver(overrides?: {
+    name?: string;
+    manufacturer?: string;
+    model?: string;
+    dataPoints?: Array<{
+        id: string;
+        name: string;
+        type: string;
+        unit?: string;
+    }>;
+}): jest.Mocked<DeviceDriver>;
+/**
+ * Create a test bridge configuration with mock driver injection
+ *
+ * This configures the bridge with dependency injection for testing,
+ * allowing integration tests to verify driver lifecycle without
+ * loading real driver packages.
+ *
+ * **Note**: Returns fresh mock instances on each call. Mock state does
+ * not persist between invocations. Each test gets independent mocks.
+ *
+ * @param broker - The test broker to connect to
+ * @param overrides - Optional configuration overrides
+ * @returns Object with bridge config and driver loader
+ *
+ * @example
+ * const { config, driverLoader, mockDriver } = createTestBridgeWithMockDriver(broker)
+ * const bridge = createBridge(config, { driverLoader })
+ * await bridge.addDevice({
+ *   deviceId: 'test-device',
+ *   driver: 'ya-modbus-driver-test',
+ *   connection: { type: 'tcp', host: 'localhost', port: 502, slaveId: 1 },
+ * })
+ * // Verify driver lifecycle with injected mocks
+ * expect(mockDriver.initialize).toHaveBeenCalled()
+ */
+export declare function createTestBridgeWithMockDriver(broker: TestBroker, overrides?: Partial<MqttBridgeConfig>): {
+    config: MqttBridgeConfig;
+    driverLoader: DriverLoader;
+    mockDriver: jest.Mocked<DeviceDriver>;
+    mockTransport: jest.Mocked<Transport>;
+    mockLoadDriverFn: jest.Mock;
+    mockTransportManager: jest.Mocked<TransportManager>;
+};
+//# sourceMappingURL=test-utils.d.ts.map

package/dist/esm/src/utils/test-utils.d.ts.map

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