4889fdaaf0
- wiki/Reference-Contracts.md: regenerate data-model (npm run wiki:all) so the two live getOutput() keys `mode` and `manualDemand` are documented; refresh stale sample values; bump code-ref badge -> a83a85e; add human note describing the two control-state keys. - CONTRACT.md: fix Port-2 outgoing topic registerChild -> child.register (registerChild is the deprecated *input* alias, not what the node emits). - test/_output-manifest.md: add the mandatory output manifest (Port 0/1/2 + emitter events + the 15-way fn_status_split fan-out) with honest coverage gaps. - test/integration/basic-dashboard-flow.test.js: fix stale fan-out count 14->15 (output 14 = percControl chart added upstream); assert out[14]. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
105 lines
3.9 KiB
JavaScript
105 lines
3.9 KiB
JavaScript
const test = require('node:test');
|
|
const assert = require('node:assert/strict');
|
|
const fs = require('node:fs');
|
|
const path = require('node:path');
|
|
|
|
function loadDashboardFlow() {
|
|
const flowPath = path.join(__dirname, '../../examples/02-Dashboard.json');
|
|
return JSON.parse(fs.readFileSync(flowPath, 'utf8'));
|
|
}
|
|
|
|
function makeContextStub() {
|
|
const store = {};
|
|
return {
|
|
get(key) {
|
|
return store[key];
|
|
},
|
|
set(key, value) {
|
|
store[key] = value;
|
|
},
|
|
};
|
|
}
|
|
|
|
test('basic dashboard flow contains the pumpingStation node and trend widgets', () => {
|
|
const flow = loadDashboardFlow();
|
|
const ps = flow.find((n) => n.type === 'pumpingStation');
|
|
const parser = flow.find((n) => n.id === 'fn_status_split');
|
|
const levelChart = flow.find((n) => n.id === 'ui_chart_level');
|
|
const volumeChart = flow.find((n) => n.id === 'ui_chart_volume');
|
|
const flowChart = flow.find((n) => n.id === 'ui_chart_flow');
|
|
|
|
assert.ok(ps, 'pumpingStation node should exist');
|
|
assert.equal(ps.type, 'pumpingStation');
|
|
assert.equal(ps.controlMode, 'levelbased');
|
|
assert.equal(ps.levelCurveType, 'linear');
|
|
assert.equal(ps.inletPipeDiameter, 0.3);
|
|
assert.equal(ps.outletPipeDiameter, 0.3);
|
|
assert.ok(parser, 'fn_status_split should exist');
|
|
assert.equal(parser.outputs, 15);
|
|
assert.equal(levelChart.type, 'ui-chart');
|
|
assert.equal(volumeChart.type, 'ui-chart');
|
|
assert.equal(flowChart.type, 'ui-chart');
|
|
});
|
|
|
|
test('basic dashboard parser routes process fields to charts and state text', () => {
|
|
const flow = loadDashboardFlow();
|
|
const parser = flow.find((n) => n.id === 'fn_status_split');
|
|
assert.ok(parser, 'fn_status_split should exist');
|
|
|
|
const func = new Function('msg', 'context', 'node', parser.func);
|
|
const context = makeContextStub();
|
|
const node = { send() {} };
|
|
|
|
// Flatten format is `${type}.${variant}.${position}.${childId}`. When the
|
|
// runtime writes without an explicit .child(), childId='default'. Mirror
|
|
// the real shape here. (See generalFunctions/src/measurements/
|
|
// MeasurementContainer.js getFlattenedOutput.)
|
|
const out = func({
|
|
payload: {
|
|
'level.predicted.atequipment.default': 3.25,
|
|
'volume.predicted.atequipment.default': 32.5,
|
|
'volumePercent.predicted.atequipment.default': 65,
|
|
'flow.predicted.in.default': 0.005,
|
|
'flow.predicted.out.default': 0.002,
|
|
'netFlowRate.predicted.atequipment.default': 0.003,
|
|
percControl: 25,
|
|
mode: 'levelbased',
|
|
direction: 'filling',
|
|
safetyState: 'normal',
|
|
isOverflowing: false,
|
|
timeleft: 400,
|
|
},
|
|
}, context, node);
|
|
|
|
assert.ok(Array.isArray(out));
|
|
assert.equal(out.length, 15);
|
|
assert.equal(out[0].payload, 'levelbased');
|
|
assert.equal(out[1].payload, 'filling');
|
|
assert.equal(out[2].payload, '3.25 m');
|
|
assert.equal(out[3].payload, '32.50 m³');
|
|
assert.equal(out[4].payload, '65.00 %');
|
|
assert.equal(out[5].payload, '25.0 %');
|
|
assert.deepEqual(out[7], { topic: 'Level', payload: 3.25 });
|
|
assert.deepEqual(out[8], { topic: 'Volume', payload: 32.5 });
|
|
assert.deepEqual(out[9], { topic: 'Volume %', payload: 65 });
|
|
assert.deepEqual(out[10], { topic: 'Inflow', payload: 18 });
|
|
assert.deepEqual(out[11], { topic: 'Outflow', payload: 7.2 });
|
|
assert.deepEqual(out[12], { topic: 'Net', payload: 10.8 });
|
|
assert.ok(Array.isArray(out[13].payload));
|
|
assert.deepEqual(out[14], { topic: 'percControl', payload: 25 });
|
|
});
|
|
|
|
test('basic dashboard parser keeps previous values when process output sends only changed fields', () => {
|
|
const flow = loadDashboardFlow();
|
|
const parser = flow.find((n) => n.id === 'fn_status_split');
|
|
const func = new Function('msg', 'context', 'node', parser.func);
|
|
const context = makeContextStub();
|
|
const node = { send() {} };
|
|
|
|
func({ payload: { 'level.predicted.atequipment.default': 3.1, percControl: 10 } }, context, node);
|
|
const out = func({ payload: { percControl: 20 } }, context, node);
|
|
|
|
assert.equal(out[2].payload, '3.10 m');
|
|
assert.equal(out[5].payload, '20.0 %');
|
|
});
|