import { createServer, type IncomingMessage, type ServerResponse } from 'node:http'; import { expect, tap } from '@git.zone/tstest/tapbundle'; import { IometerClient, IometerConfigFlow, IometerIntegration, IometerMapper, createIometerDiscoveryDescriptor, iometerProfile, type IIometerSnapshot, type TIometerRawData } from '../../ts/integrations/iometer/index.js'; const json = (responseArg: ServerResponse, valueArg: unknown, statusArg = 200): void => { responseArg.statusCode = statusArg; responseArg.setHeader('content-type', 'application/json'); responseArg.end(JSON.stringify(valueArg)); }; const rawData: TIometerRawData = { device: { id: 'iometer-device-1', name: "IOmeter Device", manufacturer: "IOmeter", model: "IOmeter local integration", serialNumber: 'iometer-serial-1', }, entities: [ { id: 'status', name: 'Status', platform: "binary_sensor", state: true, attributes: { domain: "iometer" } }, ], online: true, updatedAt: '2026-01-01T00:00:00.000Z', source: 'manual', }; tap.test('matches manual IOmeter candidates and creates config flow output', async () => { const descriptor = createIometerDiscoveryDescriptor(); const matcher = descriptor.getMatchers().find((matcherArg) => matcherArg.id === 'iometer-manual-match'); const result = await matcher!.matches({ source: 'manual', id: 'iometer-device-1', name: "IOmeter Device", metadata: { rawData } }, {}); expect(result.matched).toBeTrue(); expect(result.candidate?.integrationDomain).toEqual("iometer"); const validation = await descriptor.getValidators()[0].validate(result.candidate!, {}); expect(validation.matched).toBeTrue(); const done = await (await new IometerConfigFlow().start(result.candidate!, {})).submit!({}); expect(done.kind).toEqual('done'); expect(done.config?.uniqueId).toEqual('iometer-device-1'); expect(done.config?.rawData).toEqual(rawData); }); tap.test('maps IOmeter raw snapshots to runtime devices and entities', async () => { const client = new IometerClient({ name: "IOmeter Runtime", rawData }); const snapshot = await client.getSnapshot(); const mappedSnapshot = IometerMapper.toSnapshotFromRaw({ name: "IOmeter Runtime" }, rawData); const devices = IometerMapper.toDevices(mappedSnapshot); const entities = IometerMapper.toEntities(mappedSnapshot); expect(snapshot.online).toBeTrue(); expect(mappedSnapshot.source).toEqual('manual'); expect(devices[0].integrationDomain).toEqual("iometer"); expect(devices[0].manufacturer).toEqual("IOmeter"); expect(entities.some((entityArg) => entityArg.integrationDomain === "iometer" && entityArg.platform === "binary_sensor")).toBeTrue(); }); tap.test('reads IOmeter /v1/reading and /v1/status over local HTTP', async () => { const requests: Array<{ url?: string; userAgent?: string | string[] }> = []; const server = createServer((requestArg: IncomingMessage, responseArg: ServerResponse) => { const url = new URL(requestArg.url || '/', 'http://127.0.0.1'); requests.push({ url: url.pathname, userAgent: requestArg.headers['user-agent'] }); if (url.pathname === '/v1/reading') { json(responseArg, { meter: { number: 'METER123', reading: { time: '2026-01-01T00:00:00Z', registers: [ { obis: '01-00:01.08.00*ff', value: 12345, unit: 'Wh' }, { obis: '01-00:02.08.00*ff', value: 234, unit: 'Wh' }, { obis: '01-00:10.07.00*ff', value: 321, unit: 'W' }, { obis: '01-00:01.08.01*ff', value: 10000, unit: 'Wh' }, { obis: '01-00:01.08.02*ff', value: 2345, unit: 'Wh' }, ], }, }, }); return; } if (url.pathname === '/v1/status') { json(responseArg, { meter: { number: 'METER123' }, device: { id: 'bridge-abc', bridge: { rssi: -55, version: '1.2.3' }, core: { connectionStatus: 'connected', rssi: -61, version: '2.3.4', powerStatus: 'wired', attachmentStatus: 'attached', pinStatus: 'entered', batteryLevel: 88 }, }, }); return; } json(responseArg, { error: 'not_found' }, 404); }); await new Promise((resolve) => server.listen(0, '127.0.0.1', resolve)); try { const address = server.address(); const port = typeof address === 'object' && address ? address.port : 0; const url = `http://127.0.0.1:${port}`; const client = new IometerClient({ url, timeoutMs: 1000 }); const snapshot = await client.getSnapshot(true); const runtime = await new IometerIntegration().setup({ url, timeoutMs: 1000 }, {}); const entities = await runtime.entities(); expect(snapshot.online).toBeTrue(); expect(snapshot.source).toEqual('http'); expect(snapshot.device.serialNumber).toEqual('bridge-abc'); expect(snapshot.entities.find((entityArg) => entityArg.id === 'power')?.state).toEqual(321); expect(snapshot.entities.find((entityArg) => entityArg.id === 'connection_status')?.state).toBeTrue(); expect(entities.some((entityArg) => entityArg.state === 321 && entityArg.attributes?.deviceClass === 'power')).toBeTrue(); expect(requests.every((requestArg) => requestArg.userAgent === 'PythonIOmeter/0.1')).toBeTrue(); await runtime.destroy(); } finally { await new Promise((resolve, reject) => server.close((errorArg) => errorArg ? reject(errorArg) : resolve())); } }); tap.test('exposes IOmeter runtime and unsupported control without executor', async () => { const integration = new IometerIntegration(); expect(integration.status).toEqual("read-only-runtime"); expect(iometerProfile.metadata.configFlow).toEqual(true); expect(iometerProfile.metadata.requirements).toEqual([ "iometer==0.4.0", ]); const runtime = await integration.setup({ name: "IOmeter Runtime", rawData }, {}); const statusResult = await runtime.callService!({ domain: "iometer", service: 'status', target: {} }); const refresh = await runtime.callService!({ domain: "iometer", service: 'refresh', target: {} }); const snapshot = statusResult.data as IIometerSnapshot; expect(statusResult.success).toBeTrue(); expect(refresh.success).toBeFalse(); expect(snapshot.online).toBeTrue(); expect((await runtime.devices())[0].name).toEqual("IOmeter Device"); const command = await runtime.callService!({ domain: "iometer", service: iometerProfile.controlServices?.[0] || 'turn_on', target: {} }); expect(command.success).toBeFalse(); expect(command.error!).toContain('requires an injected client.execute() or commandExecutor'); await runtime.destroy(); }); export default tap.start();