Alex2Node/test/directives.test.js
David 1d88c7811a build: dual CJS/ESM output, ES2020 target, Node 18 floor
"exports" gains "import" and "types" next to "require": import "alex2node" failed with
ERR_PACKAGE_PATH_NOT_EXPORTED. scripts/build.mjs compiles src/ to dist/cjs, dist/esm and dist/types in a staging
directory and swaps them in only when both compiler runs passed. "main" and "types" follow for resolvers that do
not read "exports". Target ES6 -> ES2020, "engines": node >= 18, relative imports carry ".js" for Node's ESM loader.
uuid gives way to crypto.randomUUID(); mqtt is the only runtime dependency left.

Tests load the package by name. New: both entry points, the modules the builds import, dist/ equal to a fresh
build, a round trip on the ES module build, and two compiled type fixtures in place of the .d.ts regexes.
22 tests pass in 5.7 s. dist/: 16 files, 79,711 B -> 25 files, 132,291 B; the npm tarball is 25,125 B.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
2026-09-28 13:58:17 +00:00

89 lines
4.5 KiB
JavaScript

"use strict";
// Directives: a message on <root>/<endpointId>/alexaDirective reaches the device's "Event" or "ReportState" listener,
// and what the device answers is published on <root>/<endpointId>/alexaResponce.
const { test } = require("node:test");
const assert = require("node:assert/strict");
const {
Alex2MQTT, AlexaInterfaceType, DisplayCategory, PowerController, EndpointHealth, TemperatureSensorScale,
} = require("alex2node");
const { setup, directive, until } = require("./helpers/harness.js");
// A light that answers every directive with its new power state and ReportState with "off at 0 %".
function diningRoomLight(bridge) {
const lamp = bridge.registerDevice("Dining Room Light", "5020AA", DisplayCategory.LIGHT);
lamp.addCapability(AlexaInterfaceType.POWER_CONTROLLER, { proactivelyReported: true });
lamp.addCapability(AlexaInterfaceType.BRIGHTNESS_CONTROLLER);
lamp.on("Event", (request) => {
lamp.getStatusMessage(request.header.correlationToken, true)
.addHealthProp(EndpointHealth.OK)
.addPowerControllerProp(request.header.name === "TurnOn" ? PowerController.ON : PowerController.OFF)
.addBrightnessControllerProp(100)
.send(false);
});
lamp.on("ReportState", (request) => {
lamp.getStatusMessage(request.header.correlationToken)
.addPowerControllerProp(PowerController.OFF)
.addBrightnessControllerProp(0)
.send(false);
});
return lamp;
}
test("a directive reaches the \"Event\" listener and is answered with a Response carrying its correlationToken", async () => {
const { alexa, bridge } = await setup(Alex2MQTT, "root");
const dispatched = [];
bridge.on("directive", (info) => dispatched.push(info));
diningRoomLight(bridge);
alexa.send("root", directive("Alexa.PowerController", "TurnOn", "5020AA", "ct1"));
await until(() => alexa.on("root/5020AA/alexaResponce").length === 1, 3000, "directive response");
const [response] = alexa.on("root/5020AA/alexaResponce");
assert.equal(response.event.header.name, "Response");
assert.equal(response.event.header.correlationToken, "ct1");
assert.equal(response.context.properties.find((p) => p.name === "powerState").value, "ON");
assert.deepEqual(dispatched, [{ endpointId: "5020AA", namespace: "Alexa.PowerController", name: "TurnOn" }]);
});
test("ReportState reaches the \"ReportState\" listener and is answered with a StateReport", async () => {
const { alexa, bridge } = await setup(Alex2MQTT, "root");
diningRoomLight(bridge);
alexa.send("root", directive("Alexa", "ReportState", "5020AA", "ct2"));
await until(() => alexa.on("root/5020AA/alexaResponce").length === 1, 3000, "state report");
const [report] = alexa.on("root/5020AA/alexaResponce");
assert.equal(report.event.header.name, "StateReport");
assert.equal(report.event.header.correlationToken, "ct2");
assert.deepEqual(report.context.properties.map((p) => [p.name, p.value]), [["powerState", "OFF"], ["brightness", 0]]);
});
test("SceneController: Activate is answered with ActivationStarted", async () => {
const { alexa, bridge } = await setup(Alex2MQTT, "root");
const scene = bridge.registerDevice("Evening", "scene-1", DisplayCategory.SCENE_TRIGGER);
scene.addCapability(AlexaInterfaceType.SCENE_CONTROLLER);
scene.on("Event", (request) => {
scene.sendSceneResponse(request.header.correlationToken, request.header.name === "Activate");
});
alexa.send("root", directive("Alexa.SceneController", "Activate", "scene-1", "ct3"));
await until(() => alexa.on("root/scene-1/alexaResponce").length === 1, 3000, "scene response");
const [started] = alexa.on("root/scene-1/alexaResponce");
assert.equal(started.event.header.namespace, "Alexa.SceneController");
assert.equal(started.event.header.name, "ActivationStarted");
assert.equal(started.event.payload.cause.type, "VOICE_INTERACTION");
assert.ok(started.event.payload.timestamp);
});
test("the temperature helpers convert Fahrenheit to Celsius (as 1.4.0 did)", async () => {
const { bridge } = await setup(Alex2MQTT, "root");
const lamp = diningRoomLight(bridge);
const message = lamp.getStatusMessage("x")
.addTemperatureSensorProp(TemperatureSensorScale.FAHRENHEIT, 68)
.addThermostatControllerProp("lowerSetpoint", TemperatureSensorScale.FAHRENHEIT, 68)
.toJSON();
const toOneDecimal = (n) => Math.round(n * 10) / 10;
for (const name of ["temperature", "lowerSetpoint"]) {
const { value } = message.context.properties.find((p) => p.name === name);
assert.equal(toOneDecimal(value.value), 20, name);
assert.equal(value.scale, "CELSIUS", name);
}
});