registry: RangeController, ModeController, ToggleController with resources, presets and semantics
The three generic controllers are described in full and leave the stub table (62 stubs remain). A declaration
takes an instance name, friendly names from text() and asset(), and the options of the interface: range, unit and
presets for a range; supportedModes and ordered for a mode; semantics() for all three, with actions mapped to
directives and states mapped to a value or a range of values.
Refused at device.add(), each with the endpoint, interface and instance in the message: no instance name or no
friendly name; an instance declared twice; a first friendly name or a phrase used by another capability of the
endpoint; a reserved word, an asset id that is not in the catalog; range.max not above range.min; a preset off the
precision grid or outside the range; fewer than two modes or a mode listed twice; a mapping to a directive the
interface does not have, to a payload that does not fit, to a mode that is not listed, to AdjustMode on modes
that are not ordered; SetEcoOn, SetEcoOff, EcoOn and EcoOff on anything but a toggle.
For 1.x callers: Alexa.RangeController lists rangeValue (1.5.2 sent supported: []); addSupportedModes() announces
a mode given as a string as { value } and notes it, and takes { ordered: false } as a second argument, the default
stays true as 1.5.2 sent it (device.add() defaults to false). Declared the 1.x way, the zoo fan and curtain give
the same JSON as before.
Tests: the zoo blind, whose range, unit and semantics were written by hand into the JSON of 1.5.2, is declared
with device.add() and equals that JSON plus the Alexa capability; five capability objects of Amazon's examples
are reproduced the same way. 27 examples of four pages added. npm test: 108 pass (was 85) in 10.5-11.3 s, also on
Node 18.20.8 and 20.20.2.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
parent
c492ef74d1
commit
2558e21787
80 changed files with 3131 additions and 107 deletions
|
|
@ -5,7 +5,7 @@ const { test } = require("node:test");
|
|||
const assert = require("node:assert/strict");
|
||||
const {
|
||||
Alex2MQTT, ActionMapping, Alexa, AlexaActions, AlexaInterfaceType, BrightnessController, DisplayCategory, EndpointHealth,
|
||||
PowerController, TemperatureSensor, registry,
|
||||
ModeController, PowerController, RangeController, TemperatureSensor, ToggleController, asset, registry, semantics, text,
|
||||
} = require("alex2node");
|
||||
const interfaces = require("../fixtures/interfaces.js");
|
||||
const { endpoint } = require("../helpers/endpoint.js");
|
||||
|
|
@ -23,13 +23,26 @@ async function discover(alexa, root) {
|
|||
return alexa.on(`${root}/discover_r`)[before];
|
||||
}
|
||||
|
||||
for (const { namespace, page, declared } of interfaces) {
|
||||
test(`${namespace}: device.add() gives the capability object of ${page}.html`, () => {
|
||||
for (const { options, as: [example, n = 0] } of declared) {
|
||||
const capability = endpoint().add(registry.get(namespace), options);
|
||||
assert.deepEqual(capability.toJSON(), capabilities(page, namespace, example)[n], `${example}[${n}]`);
|
||||
}
|
||||
});
|
||||
// A device with the fields of a zoo endpoint and no capabilities.
|
||||
function likeTheZoo(endpointId) {
|
||||
const accepted = zoo(endpointId);
|
||||
const device = endpoint(endpointId, accepted.friendlyName, accepted.displayCategories);
|
||||
device.setDescription(accepted.description);
|
||||
device.setManufacturerName(accepted.manufacturerName);
|
||||
device.setManufacturer(accepted.additionalAttributes.manufacturer);
|
||||
device.setModel(accepted.additionalAttributes.model);
|
||||
return device;
|
||||
}
|
||||
|
||||
for (const { namespace, page: own, declared } of interfaces) {
|
||||
for (const { options, example, page = own, n = 0 } of declared) {
|
||||
test(`${namespace}: device.add() gives the capability object of ${page}.html, ${example}${n > 0 ? ` (${n})` : ""}`, () => {
|
||||
const device = endpoint();
|
||||
const capability = device.add(registry.get(namespace), options);
|
||||
assert.deepEqual(capability.toJSON(), capabilities(page, namespace, example)[n]);
|
||||
assert.deepEqual(device.check(), []);
|
||||
});
|
||||
}
|
||||
}
|
||||
|
||||
test("the fields of a capability object are in the order of the examples: type, interface, version, properties", () => {
|
||||
|
|
@ -111,17 +124,115 @@ test("1.x declarations are announced as 1.5.2 announced them, with the Alexa int
|
|||
};
|
||||
for (const [endpointId, declare] of Object.entries(declarations)) {
|
||||
const accepted = zoo(endpointId);
|
||||
const device = endpoint(endpointId, accepted.friendlyName, accepted.displayCategories);
|
||||
device.setDescription(accepted.description);
|
||||
device.setManufacturerName(accepted.manufacturerName);
|
||||
device.setManufacturer(accepted.additionalAttributes.manufacturer);
|
||||
device.setModel(accepted.additionalAttributes.model);
|
||||
const device = likeTheZoo(endpointId);
|
||||
declare(device);
|
||||
assert.deepEqual(device.getJSON(), { ...accepted, capabilities: [...accepted.capabilities, ALEXA] }, endpointId);
|
||||
assert.deepEqual(device.check(), [], endpointId);
|
||||
}
|
||||
});
|
||||
|
||||
test("a RangeController blind declared with device.add() is the zoo's blind, whose JSON was written by hand", () => {
|
||||
const blinds = likeTheZoo("zoo-blinds");
|
||||
blinds.add(RangeController, {
|
||||
instance: "Blind.Lift",
|
||||
friendlyNames: [asset("Alexa.Setting.Opening")],
|
||||
range: { min: 0, max: 100, precision: 1 },
|
||||
unit: "Alexa.Unit.Percent",
|
||||
semantics: semantics()
|
||||
.action("Close", "SetRangeValue", { rangeValue: 0 })
|
||||
.action("Open", "SetRangeValue", { rangeValue: 100 })
|
||||
.action("Lower", "AdjustRangeValue", { rangeValueDelta: -10, rangeValueDeltaDefault: false })
|
||||
.action("Raise", "AdjustRangeValue", { rangeValueDelta: 10, rangeValueDeltaDefault: false })
|
||||
.state("Closed", 0)
|
||||
.stateRange("Open", 1, 100),
|
||||
retrievable: true,
|
||||
proactivelyReported: true,
|
||||
});
|
||||
const accepted = zoo("zoo-blinds");
|
||||
assert.deepEqual(blinds.getJSON(), { ...accepted, capabilities: [...accepted.capabilities, ALEXA] });
|
||||
assert.deepEqual(blinds.check(), []);
|
||||
});
|
||||
|
||||
test("the zoo's fan and curtain declared with device.add(): a ModeController and a ToggleController with semantics", () => {
|
||||
const fan = likeTheZoo("zoo-fan");
|
||||
fan.add(PowerController, { proactivelyReported: true });
|
||||
fan.add(ModeController, {
|
||||
instance: "Fan.Speed",
|
||||
friendlyNames: [text("Speed")],
|
||||
supportedModes: ["Low", "Medium", "High"].map((name) => ({ value: `Speed.${name}`, friendlyNames: [text(name)] })),
|
||||
ordered: true,
|
||||
proactivelyReported: true,
|
||||
});
|
||||
assert.deepEqual(fan.getJSON().capabilities, [...zoo("zoo-fan").capabilities, ALEXA]);
|
||||
|
||||
const curtain = likeTheZoo("zoo-curtain");
|
||||
curtain.add(PowerController, { proactivelyReported: true });
|
||||
curtain.add(ToggleController, {
|
||||
instance: "Zoo.Shade",
|
||||
friendlyNames: [text("Shade")],
|
||||
semantics: semantics().action("Close", "TurnOn").action("Open", "TurnOff"),
|
||||
proactivelyReported: true,
|
||||
});
|
||||
assert.deepEqual(curtain.getJSON().capabilities, [...zoo("zoo-curtain").capabilities, ALEXA]);
|
||||
});
|
||||
|
||||
test("ModeController: the modes are not ordered unless the declaration says so; a mode is declared in either form", () => {
|
||||
const modes = endpoint("washer-1", "Washer", ["WASHER"]).add(ModeController, {
|
||||
instance: "Washer.WashCycle",
|
||||
friendlyNames: [asset("Alexa.Setting.WashCycle")],
|
||||
supportedModes: [
|
||||
{ value: "WashCycle.Normal", friendlyNames: [text("Normal"), text("Cottons")] },
|
||||
{ value: "WashCycle.Delicates", modeResources: { friendlyNames: [asset("Alexa.Value.Delicate"), text("Knits")] } },
|
||||
],
|
||||
});
|
||||
assert.deepEqual(modes.toJSON().configuration, {
|
||||
ordered: false,
|
||||
supportedModes: [
|
||||
{ value: "WashCycle.Normal", modeResources: { friendlyNames: [text("Normal"), text("Cottons")] } },
|
||||
{ value: "WashCycle.Delicates", modeResources: { friendlyNames: [asset("Alexa.Value.Delicate"), text("Knits")] } },
|
||||
],
|
||||
});
|
||||
});
|
||||
|
||||
test("1.x addSupportedModes: ordered as 1.x announced it, or as the second argument says; a string becomes { value }", () => {
|
||||
const fan = endpoint("fan-1", "Fan", ["FAN"]);
|
||||
const named = (value) => ({ value, modeResources: { friendlyNames: [{ "@type": "text", value: { text: value, locale: "en-US" } }] } });
|
||||
const speed = fan.addCapability(AlexaInterfaceType.MODE_CONTROLLER, { instance: "Fan.Speed" });
|
||||
speed.addFriendlyName("Speed", "en-US");
|
||||
speed.addSupportedModes([named("Low"), named("High")]);
|
||||
assert.equal(speed.getJSON().configuration.ordered, true);
|
||||
|
||||
const source = fan.addCapability(AlexaInterfaceType.MODE_CONTROLLER, { instance: "Fan.Mode" });
|
||||
source.addFriendlyName("Mode", "en-US");
|
||||
source.addSupportedModes([named("Auto"), named("On")], { ordered: false });
|
||||
assert.deepEqual(source.getJSON().configuration, { ordered: false, supportedModes: [named("Auto"), named("On")] });
|
||||
assert.deepEqual(fan.check(), []);
|
||||
|
||||
const plain = fan.addCapability(AlexaInterfaceType.MODE_CONTROLLER, { instance: "Fan.Timer" });
|
||||
plain.addFriendlyName("Countdown", "en-US");
|
||||
plain.addSupportedModes(["Short", named("Long")]);
|
||||
assert.deepEqual(plain.getJSON().configuration.supportedModes, [{ value: "Short" }, named("Long")]);
|
||||
assert.deepEqual(fan.check(), [
|
||||
'fan-1: Alexa.ModeController "Fan.Timer": supportedModes[0].friendlyNames: expected a list with 1 or more entries, got []',
|
||||
'fan-1: Alexa.ModeController "Fan.Timer": the mode Short was given as a string, pass { value, modeResources }',
|
||||
]);
|
||||
});
|
||||
|
||||
test("a 1.x RangeController has no way to give its range: announced as 1.5.2 did, with its property now, and check() says it", () => {
|
||||
const blinds = endpoint("blinds-1", "Blinds", ["INTERIOR_BLIND"]);
|
||||
const lift = blinds.addCapability(AlexaInterfaceType.RANGE_CONTROLLER, { instance: "Blind.Lift", proactivelyReported: true });
|
||||
lift.addFriendlyName("Lift", "en-US");
|
||||
assert.deepEqual(lift.getJSON(), {
|
||||
type: "AlexaInterface",
|
||||
interface: "Alexa.RangeController",
|
||||
instance: "Blind.Lift",
|
||||
version: "3",
|
||||
properties: { supported: [{ name: "rangeValue" }], proactivelyReported: true, retrievable: true },
|
||||
capabilityResources: { friendlyNames: [text("Lift")] },
|
||||
});
|
||||
assert.deepEqual(blinds.check(), ['blinds-1: Alexa.RangeController "Blind.Lift": range: expected an object with min, max, precision, got nothing']);
|
||||
});
|
||||
|
||||
test("registerDevice: every endpoint ends with the Alexa interface; alexaInterface: false leaves it out", async () => {
|
||||
const { alexa, bridge } = await setup(Alex2MQTT, "root");
|
||||
const lamp = bridge.registerDevice("Lamp", "lamp-1", DisplayCategory.LIGHT);
|
||||
|
|
|
|||
|
|
@ -4,7 +4,8 @@
|
|||
const { test } = require("node:test");
|
||||
const assert = require("node:assert/strict");
|
||||
const {
|
||||
Alex2MQTT, AlexaInterfaceType, BrightnessController, DeclarationError, EndpointHealth, PowerController, TemperatureSensor, registry,
|
||||
ActionMapping, Alex2MQTT, AlexaActions, AlexaInterfaceType, BrightnessController, DeclarationError, EndpointHealth, ModeController,
|
||||
PowerController, RangeController, TemperatureSensor, ToggleController, asset, registry, semantics, text,
|
||||
} = require("alex2node");
|
||||
const { endpoint } = require("../helpers/endpoint.js");
|
||||
const { setup, sleep } = require("../helpers/harness.js");
|
||||
|
|
@ -98,8 +99,11 @@ test("device.add refuses an option the interface does not have and a value that
|
|||
});
|
||||
|
||||
test("an endpoint takes 100 capabilities, the ones the library adds among them", () => {
|
||||
const switches = (device) => {
|
||||
for (let n = 1; n <= 98; n += 1) device.add(ToggleController, { instance: `Panel.Switch${n}`, friendlyNames: [text(`Switch ${n}`)] });
|
||||
};
|
||||
const panel = endpoint("panel-1", "Panel", ["OTHER"]);
|
||||
for (let n = 1; n <= 98; n += 1) panel.addCapability(AlexaInterfaceType.TOGGLE_CONTROLLER, { instance: `Panel.Switch${n}` });
|
||||
switches(panel);
|
||||
panel.add(PowerController);
|
||||
assert.equal(panel.getJSON().capabilities.length, 100);
|
||||
assert.deepEqual(panel.check(), []);
|
||||
|
|
@ -114,7 +118,7 @@ test("an endpoint takes 100 capabilities, the ones the library adds among them",
|
|||
// With Alexa.EndpointHealth added for the device there is room for 98
|
||||
const health = endpoint("panel-2", "Panel", ["OTHER"]);
|
||||
health.endpointHealth = true;
|
||||
for (let n = 1; n <= 98; n += 1) health.addCapability(AlexaInterfaceType.TOGGLE_CONTROLLER, { instance: `Panel.Switch${n}` });
|
||||
switches(health);
|
||||
assert.equal(refused(() => health.add(PowerController)).message, "panel-2: 101 capabilities, an endpoint takes 100");
|
||||
assert.doesNotThrow(() => health.add(EndpointHealth));
|
||||
});
|
||||
|
|
@ -127,12 +131,166 @@ test("check() lists what is wrong with a device declared the 1.x way, one line f
|
|||
fan.addCapability(AlexaInterfaceType.POWER_CONTROLLER, { instance: "Fan.Power" });
|
||||
fan.addCapability(AlexaInterfaceType.TOGGLE_CONTROLLER, { instance: "Fan.Oscillate" });
|
||||
fan.addCapability(AlexaInterfaceType.TOGGLE_CONTROLLER, { instance: "Fan.Oscillate" });
|
||||
fan.addCapability(AlexaInterfaceType.TOGGLE_CONTROLLER).addFriendlyName("Light", "en-US");
|
||||
fan.addCapability(AlexaInterfaceType.RANGE_CONTROLLER, { instance: "Fan.Speed" }).addFriendlyName("Speed", "en-US");
|
||||
const mode = fan.addCapability(AlexaInterfaceType.MODE_CONTROLLER, { instance: "Fan.Mode" });
|
||||
mode.addFriendlyName("Volume", "en-US");
|
||||
mode.addSupportedModes(["Auto"]);
|
||||
const direction = fan.addCapability(AlexaInterfaceType.TOGGLE_CONTROLLER, { instance: "Fan.Direction" });
|
||||
direction.addFriendlyName("Speed", "en-US");
|
||||
direction.addActionMapping(new ActionMapping([AlexaActions.Open], "Reverse"));
|
||||
assert.deepEqual(fan.check(), [
|
||||
'fan-1: "VEHICLE" is not a display category',
|
||||
'fan-1: Alexa.PowerController "Fan.Power": takes no instance name: an endpoint has the interface once',
|
||||
'fan-1: Alexa.ToggleController "Fan.Oscillate": needs a friendly name, from text() or asset()',
|
||||
'fan-1: Alexa.ToggleController "Fan.Oscillate": the instance is declared twice',
|
||||
"fan-1: Alexa.ToggleController: needs an instance name, like Blind.Lift",
|
||||
'fan-1: Alexa.RangeController "Fan.Speed": range: expected an object with min, max, precision, got nothing',
|
||||
'fan-1: Alexa.ModeController "Fan.Mode": friendlyNames[0].value.text: "Volume" is a reserved word, not to be used as a friendly name',
|
||||
'fan-1: Alexa.ModeController "Fan.Mode": the mode Auto was given as a string, pass { value, modeResources }',
|
||||
'fan-1: Alexa.ToggleController "Fan.Direction": the first friendly name, Speed, is the first of Alexa.RangeController "Fan.Speed" too',
|
||||
]);
|
||||
assert.equal(fan.getJSON().capabilities.length, 4, "announced all the same");
|
||||
assert.equal(fan.getJSON().capabilities.length, 8, "announced all the same");
|
||||
});
|
||||
|
||||
// A blind with a lift from 0 to 100: what each case below declares on top of it
|
||||
const LIFT = { instance: "Blind.Lift", friendlyNames: [asset("Alexa.Setting.Opening")], range: { min: 0, max: 100, precision: 5 } };
|
||||
const POSITION = {
|
||||
instance: "Blind.Position",
|
||||
friendlyNames: [text("Position")],
|
||||
supportedModes: [
|
||||
{ value: "Position.Up", friendlyNames: [asset("Alexa.Value.Open")] },
|
||||
{ value: "Position.Down", friendlyNames: [asset("Alexa.Value.Close")] },
|
||||
],
|
||||
};
|
||||
const TILT = { instance: "Blind.Tilt", friendlyNames: [text("Tilt")] };
|
||||
const without = (options, ...keys) => Object.fromEntries(Object.entries(options).filter(([key]) => !keys.includes(key)));
|
||||
|
||||
test("a generic controller needs an instance name and a friendly name, and each instance is declared once", () => {
|
||||
const cases = [
|
||||
[RangeController, without(LIFT, "instance"), "Alexa.RangeController: needs an instance name, like Blind.Lift"],
|
||||
[ModeController, without(POSITION, "instance"), "Alexa.ModeController: needs an instance name, like Blind.Lift"],
|
||||
[ToggleController, { ...TILT, instance: "" }, "Alexa.ToggleController: needs an instance name, like Blind.Lift"],
|
||||
[RangeController, without(LIFT, "friendlyNames"), 'Alexa.RangeController "Blind.Lift": needs a friendly name, from text() or asset()'],
|
||||
[ModeController, { ...POSITION, friendlyNames: [] }, 'Alexa.ModeController "Blind.Position": needs a friendly name, from text() or asset()'],
|
||||
[ToggleController, without(TILT, "friendlyNames"), 'Alexa.ToggleController "Blind.Tilt": needs a friendly name, from text() or asset()'],
|
||||
];
|
||||
for (const [descriptor, options, message] of cases) {
|
||||
assert.equal(refused(() => endpoint("blinds-1").add(descriptor, options)).message, `blinds-1: ${message}`);
|
||||
}
|
||||
|
||||
const blinds = endpoint("blinds-1");
|
||||
blinds.add(ToggleController, TILT);
|
||||
assert.equal(
|
||||
refused(() => blinds.add(ToggleController, { ...TILT, friendlyNames: [text("Slats")] })).message,
|
||||
'blinds-1: Alexa.ToggleController "Blind.Tilt": the instance is declared twice'
|
||||
);
|
||||
// The same instance name under another interface is another capability
|
||||
blinds.add(RangeController, { ...LIFT, instance: "Blind.Tilt" });
|
||||
assert.equal(blinds.getCapabilities().length, 2);
|
||||
});
|
||||
|
||||
test("friendly names: an asset of the catalog or a text with a locale, no reserved word, the first one once on the endpoint", () => {
|
||||
const named = (...friendlyNames) => () => endpoint("blinds-1").add(ToggleController, { ...TILT, friendlyNames });
|
||||
const cases = [
|
||||
[named(text("volume")), 'friendlyNames[0].value.text: "volume" is a reserved word, not to be used as a friendly name'],
|
||||
[named(text("Tilt"), text("Night Light")), 'friendlyNames[1].value.text: "Night Light" is a reserved word, not to be used as a friendly name'],
|
||||
[named(asset("Alexa.Setting.Tilt")), 'friendlyNames[0].value.assetId: expected an id of the global Alexa catalog, like Alexa.Setting.Opening, got "Alexa.Setting.Tilt"'],
|
||||
[named(text("Tilt", "english")), 'friendlyNames[0].value.locale: expected a locale like en-US, got "english"'],
|
||||
[named(text("")), 'friendlyNames[0].value.text: expected a string of 1 or more characters, got ""'],
|
||||
[named("Tilt"), 'friendlyNames[0]: expected a friendly name, from text() or asset(), got "Tilt"'],
|
||||
[named({ "@type": "name", value: "Tilt" }), 'friendlyNames[0].@type: expected text | asset, got "name"'],
|
||||
];
|
||||
for (const [declare, message] of cases) assert.equal(refused(declare).message, `blinds-1: Alexa.ToggleController "Blind.Tilt": ${message}`);
|
||||
|
||||
const blinds = endpoint("blinds-1");
|
||||
blinds.add(RangeController, LIFT);
|
||||
blinds.add(ToggleController, TILT);
|
||||
assert.equal(
|
||||
refused(() => blinds.add(ModeController, { ...POSITION, friendlyNames: [text("tilt"), text("Position")] })).message,
|
||||
'blinds-1: Alexa.ModeController "Blind.Position": the first friendly name, tilt, is the first of Alexa.ToggleController "Blind.Tilt" too'
|
||||
);
|
||||
assert.equal(
|
||||
refused(() => blinds.add(ModeController, { ...POSITION, friendlyNames: [asset("Alexa.Setting.Opening")] })).message,
|
||||
'blinds-1: Alexa.ModeController "Blind.Position": the first friendly name, Alexa.Setting.Opening, is the first of Alexa.RangeController "Blind.Lift" too'
|
||||
);
|
||||
// Second names may repeat, and the same text in another language is another name
|
||||
blinds.add(ModeController, { ...POSITION, friendlyNames: [text("Tilt", "en-GB"), text("Tilt")] });
|
||||
assert.equal(blinds.getCapabilities().length, 3);
|
||||
});
|
||||
|
||||
test("RangeController: a range, presets on its grid, a unit of measure", () => {
|
||||
const lift = (options) => () => endpoint("blinds-1").add(RangeController, { ...LIFT, ...options });
|
||||
const preset = (value) => ({ value, friendlyNames: [text("Half")] });
|
||||
const cases = [
|
||||
[() => endpoint("blinds-1").add(RangeController, without(LIFT, "range")), "range: expected an object with min, max, precision, got nothing"],
|
||||
[lift({ range: { min: 0, max: 100 } }), "range.precision: expected a number greater than 0, got nothing"],
|
||||
[lift({ range: { min: 0, max: 100, precision: 0 } }), "range.precision: expected a number greater than 0, got 0"],
|
||||
[lift({ range: { min: 0, max: 100, step: 5 } }), "range.step: unknown key, the known ones are min, max, precision"],
|
||||
[lift({ range: { min: 100, max: 0, precision: 5 } }), "range.max 0 is not above range.min 100"],
|
||||
[lift({ presets: [preset(50), preset(52)] }), "the preset 52 is not 0 + n x 5, up to 100"],
|
||||
[lift({ presets: [preset(105)] }), "the preset 105 is not 0 + n x 5, up to 100"],
|
||||
[lift({ presets: [{ value: 50 }] }), "presets[0].friendlyNames: expected a list with 1 or more entries, got nothing"],
|
||||
[lift({ presets: [{ value: 50, friendlyNames: [text("Timer")] }] }), 'presets[0].friendlyNames[0].value.text: "Timer" is a reserved word, not to be used as a friendly name'],
|
||||
[lift({ unit: "Alexa.Unit.Percentage" }), 'unit: expected a unit of measure like Alexa.Unit.Percent, got "Alexa.Unit.Percentage"'],
|
||||
[lift({ preset: [] }), "preset: unknown key, the known ones are range, unit, presets, semantics"],
|
||||
[lift({ semantics: semantics().action("Open", "SetRangeValue", { rangeValue: 1000 }) }), "an action is mapped to SetRangeValue 1000, the range is 0 to 100"],
|
||||
];
|
||||
for (const [declare, message] of cases) assert.equal(refused(declare).message, `blinds-1: Alexa.RangeController "Blind.Lift": ${message}`);
|
||||
|
||||
// A grid that does not start at 0, and one of tenths
|
||||
const fan = endpoint("fan-1");
|
||||
fan.add(RangeController, { ...LIFT, range: { min: 1, max: 10, precision: 3 }, presets: [preset(1), preset(4), preset(10)] });
|
||||
fan.add(RangeController, {
|
||||
instance: "Fan.Angle",
|
||||
friendlyNames: [text("Angle")],
|
||||
range: { min: 0, max: 1, precision: 0.1 },
|
||||
presets: [{ value: 0.3, friendlyNames: [text("Narrow")] }, { value: 0.7, friendlyNames: [text("Wide")] }],
|
||||
});
|
||||
assert.equal(fan.getCapabilities().length, 2);
|
||||
});
|
||||
|
||||
test("ModeController: two modes or more, each once, and mappings to modes it has", () => {
|
||||
const position = (options) => () => endpoint("blinds-1").add(ModeController, { ...POSITION, ...options });
|
||||
const [up, down] = POSITION.supportedModes;
|
||||
const cases = [
|
||||
[() => endpoint("blinds-1").add(ModeController, without(POSITION, "supportedModes")), "supportedModes: expected a list with 2 or more entries, got nothing"],
|
||||
[position({ supportedModes: [up] }), /^supportedModes: expected a list with 2 or more entries, got \[\{"value":"Position\.Up"/],
|
||||
[position({ supportedModes: [up, down, up] }), "the mode Position.Up is listed twice"],
|
||||
[position({ supportedModes: [up, { value: "Position.Down" }] }), "supportedModes[1].friendlyNames: expected a list with 1 or more entries, got nothing"],
|
||||
[position({ supportedModes: [up, "Position.Down"] }), 'supportedModes[1]: expected a mode { value, friendlyNames }, got "Position.Down"'],
|
||||
[position({ ordered: "yes" }), 'ordered: expected true or false, got "yes"'],
|
||||
[position({ semantics: semantics().action("Open", "SetMode", { mode: "Position.Open" }) }), "an action is mapped to SetMode Position.Open, the modes are Position.Up, Position.Down"],
|
||||
[position({ semantics: semantics().state("Closed", "Position.Closed") }), "a state is mapped to Position.Closed, the modes are Position.Up, Position.Down"],
|
||||
[position({ semantics: semantics().action("Raise", "AdjustMode", { modeDelta: 1 }) }), "an action is mapped to AdjustMode, which needs ordered: true"],
|
||||
];
|
||||
for (const [declare, message] of cases) {
|
||||
const prefix = 'blinds-1: Alexa.ModeController "Blind.Position": ';
|
||||
if (typeof message === "string") assert.equal(refused(declare).message, prefix + message);
|
||||
else assert.match(refused(declare).message.slice(prefix.length), message);
|
||||
}
|
||||
|
||||
const ordered = position({ ordered: true, semantics: semantics().action("Raise", "AdjustMode", { modeDelta: -1 }) })();
|
||||
const unordered = position({})();
|
||||
const { AdjustMode } = ModeController.directives;
|
||||
assert.deepEqual([AdjustMode.when(ordered), AdjustMode.when(unordered)], [true, false], "Alexa sends AdjustMode to an ordered mode only");
|
||||
});
|
||||
|
||||
test("a phrase is mapped once on an endpoint, across its Range, Mode and Toggle capabilities", () => {
|
||||
const blinds = endpoint("blinds-1");
|
||||
blinds.add(RangeController, { ...LIFT, semantics: semantics().action(["Open", "Raise"], "SetRangeValue", { rangeValue: 100 }) });
|
||||
assert.equal(
|
||||
refused(() => blinds.add(ToggleController, { ...TILT, semantics: semantics().action("Close", "TurnOff").action("Open", "TurnOn") })).message,
|
||||
'blinds-1: Alexa.ToggleController "Blind.Tilt": Alexa.Actions.Open is mapped here and on Alexa.RangeController "Blind.Lift", an endpoint maps a phrase once'
|
||||
);
|
||||
assert.equal(
|
||||
refused(() => blinds.add(ModeController, { ...POSITION, semantics: semantics().action("Lower", "SetMode", { mode: "Position.Down" }).action(["Close", "Lower"], "SetMode", { mode: "Position.Down" }) })).message,
|
||||
'blinds-1: Alexa.ModeController "Blind.Position": Alexa.Actions.Lower is mapped twice, an endpoint maps a phrase once'
|
||||
);
|
||||
blinds.add(ToggleController, { ...TILT, semantics: semantics().action("Close", "TurnOff").action("Lower", "TurnOff") });
|
||||
|
||||
// Another endpoint maps the same phrases
|
||||
endpoint("blinds-2").add(ToggleController, { ...TILT, semantics: semantics().action("Open", "TurnOn") });
|
||||
});
|
||||
|
||||
test("a stub is declared like any interface and checked for nothing but being declared twice", () => {
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue