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

package/dist/src/utils/test-utils.js

@@ -0,0 +1,535 @@
+// Non-null assertions are used for event handler cleanup where the handlers are guaranteed to be defined
+// by control flow. Using optional chaining would create untestable branches for impossible null cases.
+import { createServer } from 'node:net';
+import { jest } from '@jest/globals';
+import Aedes from 'aedes';
+import { DriverLoader } from '../driver-loader.js';
+import { createBridge } from '../index.js';
+/**
+ * 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 function withTimeout(promise, timeoutMs, errorMessage) {
+    let timeoutId;
+    const timeoutPromise = new Promise((_, reject) => {
+        timeoutId = setTimeout(() => {
+            const message = typeof errorMessage === 'function' ? errorMessage() : errorMessage;
+            reject(new Error(message));
+        }, timeoutMs);
+    });
+    return Promise.race([promise, timeoutPromise]).finally(() => {
+        clearTimeout(timeoutId);
+    });
+}
+/**
+ * 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 function waitForAllClientsToDisconnect(broker, timeoutMs = 5000) {
+    if (broker.broker.connectedClients === 0) {
+        return Promise.resolve();
+    }
+    let onDisconnect;
+    const disconnectPromise = new Promise((resolve) => {
+        onDisconnect = () => {
+            if (broker.broker.connectedClients === 0) {
+                broker.broker.off('clientDisconnect', onDisconnect);
+                resolve();
+            }
+        };
+        broker.broker.on('clientDisconnect', onDisconnect);
+    });
+    return withTimeout(disconnectPromise, timeoutMs, () => `Timeout waiting for clients to disconnect. Still connected: ${broker.broker.connectedClients}`).finally(() => {
+        broker.broker.off('clientDisconnect', onDisconnect);
+    });
+}
+/**
+ * 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 function waitForClientReady(broker, timeoutMs = 2000) {
+    let onClientReady;
+    const clientReadyPromise = new Promise((resolve) => {
+        onClientReady = () => {
+            broker.broker.off('clientReady', onClientReady);
+            resolve();
+        };
+        broker.broker.on('clientReady', onClientReady);
+    });
+    return withTimeout(clientReadyPromise, timeoutMs, () => `Timeout waiting for client to be ready (connected: ${broker.broker.connectedClients})`).finally(() => {
+        broker.broker.off('clientReady', onClientReady);
+    });
+}
+/**
+ * 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 function waitForClientDisconnect(broker, timeoutMs = 2000) {
+    let onClientDisconnect;
+    const clientDisconnectPromise = new Promise((resolve) => {
+        onClientDisconnect = () => {
+            broker.broker.off('clientDisconnect', onClientDisconnect);
+            resolve();
+        };
+        broker.broker.on('clientDisconnect', onClientDisconnect);
+    });
+    return withTimeout(clientDisconnectPromise, timeoutMs, () => `Timeout waiting for client to disconnect (connected: ${broker.broker.connectedClients})`).finally(() => {
+        broker.broker.off('clientDisconnect', onClientDisconnect);
+    });
+}
+/**
+ * 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 function waitForPublish(broker, topicPattern, timeoutMs = 1000) {
+    let onPublish;
+    const publishPromise = new Promise((resolve) => {
+        onPublish = (packet, _client) => {
+            if (!topicPattern || matchTopic(packet.topic, topicPattern)) {
+                broker.broker.off('publish', onPublish);
+                const payload = typeof packet.payload === 'string' ? Buffer.from(packet.payload) : packet.payload;
+                resolve({ topic: packet.topic, payload });
+            }
+        };
+        broker.broker.on('publish', onPublish);
+    });
+    return withTimeout(publishPromise, timeoutMs, `Timeout waiting for publish${topicPattern ? ` on topic ${topicPattern}` : ''}`).finally(() => {
+        broker.broker.off('publish', onPublish);
+    });
+}
+/**
+ * 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 function waitForSubscribe(broker, topicPattern, timeoutMs = 1000) {
+    let onSubscribe;
+    const subscribePromise = new Promise((resolve) => {
+        onSubscribe = (subscriptions) => {
+            if (!topicPattern || subscriptions.some((s) => matchTopic(s.topic, topicPattern))) {
+                broker.broker.off('subscribe', onSubscribe);
+                resolve(subscriptions);
+            }
+        };
+        broker.broker.on('subscribe', onSubscribe);
+    });
+    return withTimeout(subscribePromise, timeoutMs, `Timeout waiting for subscribe${topicPattern ? ` on topic ${topicPattern}` : ''}`).finally(() => {
+        broker.broker.off('subscribe', onSubscribe);
+    });
+}
+/**
+ * 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 function waitForUnsubscribe(broker, topicPattern, timeoutMs = 1000) {
+    let onUnsubscribe;
+    const unsubscribePromise = new Promise((resolve) => {
+        onUnsubscribe = (unsubscriptions) => {
+            if (!topicPattern || unsubscriptions.some((topic) => matchTopic(topic, topicPattern))) {
+                broker.broker.off('unsubscribe', onUnsubscribe);
+                resolve(unsubscriptions);
+            }
+        };
+        broker.broker.on('unsubscribe', onUnsubscribe);
+    });
+    return withTimeout(unsubscribePromise, timeoutMs, `Timeout waiting for unsubscribe${topicPattern ? ` on topic ${topicPattern}` : ''}`).finally(() => {
+        broker.broker.off('unsubscribe', onUnsubscribe);
+    });
+}
+/**
+ * Simple topic matcher that supports MQTT wildcards
+ *
+ * @param topic - The actual topic
+ * @param pattern - The pattern to match (supports + and # wildcards)
+ * @returns True if topic matches pattern
+ */
+function matchTopic(topic, pattern) {
+    if (topic === pattern)
+        return true;
+    const topicParts = topic.split('/');
+    const patternParts = pattern.split('/');
+    for (let i = 0; i < patternParts.length; i++) {
+        if (patternParts[i] === '#') {
+            return true;
+        }
+        if (patternParts[i] !== '+' && patternParts[i] !== topicParts[i]) {
+            return false;
+        }
+    }
+    return topicParts.length === patternParts.length;
+}
+/**
+ * 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 function createTestBridgeConfig(broker, overrides) {
+    const { mqtt, ...otherOverrides } = overrides ?? {};
+    return {
+        mqtt: {
+            url: broker.url,
+            ...mqtt,
+        },
+        ...otherOverrides,
+    };
+}
+/**
+ * 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 async function subscribeAndWait(bridge, broker, topic, handler, options) {
+    const prefix = options?.prefix ?? 'modbus';
+    const subscribePromise = waitForSubscribe(broker, `${prefix}/${topic}`);
+    await bridge.subscribe(topic, handler, options);
+    await subscribePromise;
+}
+/**
+ * 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 async function publishAndWait(bridge, broker, topic, message, options) {
+    const prefix = options?.prefix ?? 'modbus';
+    const publishPromise = waitForPublish(broker, `${prefix}/${topic}`);
+    await bridge.publish(topic, message, options);
+    await publishPromise;
+}
+/**
+ * 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 function createMessageCollector() {
+    const messages = [];
+    return {
+        messages,
+        handler: (message) => messages.push(message.payload.toString()),
+        clear: () => {
+            messages.length = 0;
+        },
+    };
+}
+/**
+ * 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 async function withBridge(config, testFn) {
+    const bridge = createBridge(config);
+    await bridge.start();
+    try {
+        await testFn(bridge);
+    }
+    finally {
+        await bridge.stop();
+    }
+}
+/**
+ * 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 async function withBridgeAndMockDriver(broker, testFn, overrides) {
+    const { config, driverLoader, mockDriver, mockTransport, mockLoadDriverFn, mockTransportManager, } = createTestBridgeWithMockDriver(broker, overrides);
+    const bridge = createBridge(config, { driverLoader });
+    await bridge.start();
+    try {
+        await testFn(bridge, { mockDriver, mockTransport, mockLoadDriverFn, mockTransportManager });
+    }
+    finally {
+        await bridge.stop();
+    }
+}
+/**
+ * Start an Aedes MQTT broker on a dynamic port for testing
+ */
+export async function startTestBroker(options) {
+    const broker = new Aedes();
+    const server = createServer(broker.handle);
+    return new Promise((resolve, reject) => {
+        server.listen(options?.port, () => {
+            const address = server.address();
+            resolve({
+                address,
+                url: `mqtt://localhost:${address.port}`,
+                port: address.port,
+                broker,
+                server,
+                close: () => new Promise((resolveClose, rejectClose) => {
+                    broker.close(() => {
+                        server.close((err) => {
+                            if (err) {
+                                rejectClose(err);
+                            }
+                            else {
+                                resolveClose();
+                            }
+                        });
+                    });
+                }),
+            });
+        });
+        server.on('error', reject);
+    });
+}
+/**
+ * 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 function createMockTransport() {
+    return {
+        readHoldingRegisters: jest.fn().mockResolvedValue([0, 0]),
+        readInputRegisters: jest.fn().mockResolvedValue([0, 0]),
+        readCoils: jest.fn().mockResolvedValue([false]),
+        readDiscreteInputs: jest.fn().mockResolvedValue([false]),
+        writeSingleCoil: jest.fn().mockResolvedValue(undefined),
+        writeSingleRegister: jest.fn().mockResolvedValue(undefined),
+        writeMultipleRegisters: jest.fn().mockResolvedValue(undefined),
+        writeMultipleCoils: jest.fn().mockResolvedValue(undefined),
+        close: jest.fn().mockResolvedValue(undefined),
+    };
+}
+/**
+ * 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 function createMockTransportManager() {
+    const mockTransport = createMockTransport();
+    return {
+        getTransport: jest.fn().mockResolvedValue(mockTransport),
+        getStats: jest
+            .fn()
+            .mockReturnValue({ totalTransports: 0, rtuTransports: 0, tcpTransports: 0 }),
+        closeAll: jest.fn().mockResolvedValue(undefined),
+    };
+}
+/**
+ * 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 function createMockDriver(overrides) {
+    return {
+        name: overrides?.name ?? 'test-device',
+        manufacturer: overrides?.manufacturer ?? 'Test Manufacturer',
+        model: overrides?.model ?? 'TEST-001',
+        dataPoints: (overrides?.dataPoints ?? [
+            {
+                id: 'test-value',
+                name: 'Test Value',
+                type: 'number',
+                unit: 'unit',
+            },
+        ]),
+        readDataPoint: jest.fn().mockResolvedValue(123),
+        writeDataPoint: jest.fn().mockResolvedValue(undefined),
+        readDataPoints: jest.fn().mockResolvedValue({ 'test-value': 123 }),
+        initialize: jest.fn().mockResolvedValue(undefined),
+        destroy: jest.fn().mockResolvedValue(undefined),
+    };
+}
+/**
+ * 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 function createTestBridgeWithMockDriver(broker, overrides) {
+    // Create first instances for single-device test convenience
+    const mockDriver = createMockDriver();
+    const mockTransport = createMockTransport();
+    // Mock loadDriverFn that creates NEW instances on each call for driver isolation
+    // First call returns the pre-created mockDriver for backward compatibility
+    let isFirstDriverCall = true;
+    const mockLoadDriverFn = jest.fn().mockImplementation(() => {
+        return Promise.resolve({
+            createDriver: jest.fn().mockImplementation(() => {
+                if (isFirstDriverCall) {
+                    isFirstDriverCall = false;
+                    return Promise.resolve(mockDriver);
+                }
+                return Promise.resolve(createMockDriver());
+            }),
+        });
+    });
+    // Create mock TransportManager that returns NEW transport instances for isolation
+    // First call returns the pre-created mockTransport for backward compatibility
+    let isFirstTransportCall = true;
+    const mockTransportManager = createMockTransportManager();
+    mockTransportManager.getTransport.mockImplementation(() => {
+        if (isFirstTransportCall) {
+            isFirstTransportCall = false;
+            return Promise.resolve(mockTransport);
+        }
+        return Promise.resolve(createMockTransport());
+    });
+    // Create DriverLoader with mocked dependencies
+    const driverLoader = new DriverLoader(mockLoadDriverFn, mockTransportManager);
+    return {
+        config: createTestBridgeConfig(broker, overrides),
+        driverLoader,
+        mockDriver,
+        mockTransport,
+        mockLoadDriverFn,
+        mockTransportManager,
+    };
+}
+//# sourceMappingURL=test-utils.js.map

package/dist/src/utils/test-utils.js.map

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