Files
integrations/test/iperf3/test.iperf3.node.ts
T

100 lines
4.5 KiB
TypeScript

import { expect, tap } from '@git.zone/tstest/tapbundle';
import { HomeAssistantIperf3Integration, Iperf3Client, Iperf3ConfigFlow, Iperf3Integration, Iperf3Mapper, createIperf3DiscoveryDescriptor, iperf3Profile, type IIperf3Snapshot, type TIperf3RawData } from '../../ts/integrations/iperf3/index.js';
const rawData: TIperf3RawData = {
device: {
id: 'iperf3-device-1',
name: "Iperf3 Device",
manufacturer: "Iperf3",
model: "Iperf3 local integration",
serialNumber: 'iperf3-serial-1',
},
entities: [
{ id: 'status', name: 'Status', platform: "sensor", state: true, attributes: { domain: "iperf3" } },
],
online: true,
updatedAt: '2026-01-01T00:00:00.000Z',
source: 'manual',
};
tap.test('matches manual Iperf3 candidates and creates config flow output', async () => {
const descriptor = createIperf3DiscoveryDescriptor();
const matcher = descriptor.getMatchers().find((matcherArg) => matcherArg.id === 'iperf3-manual-match');
const result = await matcher!.matches({ source: 'manual', id: 'iperf3-device-1', name: "Iperf3 Device", metadata: { rawData } }, {});
expect(result.matched).toBeTrue();
expect(result.candidate?.integrationDomain).toEqual("iperf3");
const validation = await descriptor.getValidators()[0].validate(result.candidate!, {});
expect(validation.matched).toBeTrue();
const done = await (await new Iperf3ConfigFlow().start(result.candidate!, {})).submit!({});
expect(done.kind).toEqual('done');
expect(done.config?.uniqueId).toEqual('iperf3-device-1');
expect(done.config?.rawData).toEqual(rawData);
});
tap.test('maps Iperf3 raw snapshots to runtime devices and entities', async () => {
const client = new Iperf3Client({ name: "Iperf3 Runtime", rawData });
const snapshot = await client.getSnapshot();
const mappedSnapshot = Iperf3Mapper.toSnapshotFromRaw({ name: "Iperf3 Runtime" }, rawData);
const devices = Iperf3Mapper.toDevices(mappedSnapshot);
const entities = Iperf3Mapper.toEntities(mappedSnapshot);
expect(snapshot.online).toBeTrue();
expect(mappedSnapshot.source).toEqual('manual');
expect(devices[0].integrationDomain).toEqual("iperf3");
expect(devices[0].manufacturer).toEqual("Iperf3");
expect(entities.some((entityArg) => entityArg.integrationDomain === "iperf3" && entityArg.platform === "sensor")).toBeTrue();
});
tap.test('does not treat arbitrary Iperf3 host/path as a native live API', async () => {
const originalFetch = globalThis.fetch;
let fetched = false;
globalThis.fetch = (async () => {
fetched = true;
return new Response('{}');
}) as typeof globalThis.fetch;
try {
const snapshot = await new Iperf3Client({ host: '127.0.0.1', path: '/api', timeoutMs: 1000 }).getSnapshot(true);
expect(fetched).toBeFalse();
expect(snapshot.online).toBeFalse();
expect(snapshot.error!).toContain('snapshots require');
} finally {
globalThis.fetch = originalFetch;
}
});
tap.test('exposes Iperf3 runtime, HA alias, and unsupported control without executor', async () => {
const integration = new Iperf3Integration();
const alias = new HomeAssistantIperf3Integration();
expect(alias instanceof Iperf3Integration).toBeTrue();
expect(alias.domain).toEqual("iperf3");
expect(integration.status).toEqual("control-runtime");
expect(iperf3Profile.metadata.configFlow).toEqual(false);
expect(iperf3Profile.metadata.requirements).toEqual([
"iperf3==0.1.11",
]);
expect((iperf3Profile.metadata.localApi as { status: string }).status).toContain('libiperf');
expect((iperf3Profile.metadata.localApi as { explicitUnsupported: string[] }).explicitUnsupported.some((entryArg) => entryArg.includes('libiperf.so'))).toBeTrue();
const runtime = await integration.setup({ name: "Iperf3 Runtime", rawData }, {});
const statusResult = await runtime.callService!({ domain: "iperf3", service: 'status', target: {} });
const refresh = await runtime.callService!({ domain: "iperf3", service: 'refresh', target: {} });
const snapshot = statusResult.data as IIperf3Snapshot;
expect(statusResult.success).toBeTrue();
expect(refresh.success).toBeTrue();
expect(snapshot.online).toBeTrue();
expect((await runtime.devices())[0].name).toEqual("Iperf3 Device");
const command = await runtime.callService!({ domain: "iperf3", service: iperf3Profile.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();