David
2558e21787
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>
67 lines
2.8 KiB
JavaScript
67 lines
2.8 KiB
JavaScript
import { Capability } from "../device/Capability.js";
|
|
import { registry } from "../registry/index.js";
|
|
import { text } from "../registry/resources.js";
|
|
/**
|
|
* A capability as 1.x declares it: device.addCapability(type, options), then the add and set methods below. It is a
|
|
* Capability, so what the methods set reaches discovery the same way as the options of device.add(). Nothing is
|
|
* refused here except an interface name the registry does not have: what Alexa would reject is logged by the bridge
|
|
* when it answers a discovery.
|
|
*/
|
|
export class AlexaInterface extends Capability {
|
|
constructor(type, retrievable = true, proactivelyReported = false, instance = "") {
|
|
super(registry.get(type), { retrievable, proactivelyReported, instance, options: {} });
|
|
}
|
|
/** The namespace of the interface, which is the value of its AlexaInterfaceType member. */
|
|
get type() {
|
|
return this.descriptor.namespace;
|
|
}
|
|
addActionMapping(mapping) {
|
|
var _a;
|
|
const semantics = ((_a = this.options).semantics ?? (_a.semantics = {}));
|
|
(semantics.actionMappings ?? (semantics.actionMappings = [])).push(mapping.toJSON());
|
|
if (mapping.deprecation)
|
|
this.notes.push(mapping.deprecation);
|
|
}
|
|
addFriendlyName(name, locale) {
|
|
this.friendlyNames.push(text(name, locale));
|
|
}
|
|
/**
|
|
* The modes of a ModeController, as { value, modeResources } objects. A mode given as a string is announced as
|
|
* { value } and noted: Alexa wants friendly names for it. ordered is true unless options.ordered says otherwise,
|
|
* as 1.x announced every mode list; with device.add() the default is false.
|
|
*/
|
|
addSupportedModes(modes, options = {}) {
|
|
this.options.ordered = options.ordered ?? true;
|
|
this.options.supportedModes = modes.map((mode) => {
|
|
if (typeof mode !== "string")
|
|
return { value: mode.value, friendlyNames: (mode.modeResources?.friendlyNames ?? []) };
|
|
this.notes.push(`the mode ${mode} was given as a string, pass { value, modeResources }`);
|
|
return { value: mode, friendlyNames: [] };
|
|
});
|
|
}
|
|
setInstance(name) {
|
|
this.instance = name;
|
|
}
|
|
getType() {
|
|
return this.type;
|
|
}
|
|
/** @deprecated The same as getType(). */
|
|
getTypeString() {
|
|
return this.type;
|
|
}
|
|
/** @deprecated Read descriptor.version. */
|
|
getVersion() {
|
|
return this.descriptor.version;
|
|
}
|
|
/** @deprecated Read the keys of descriptor.properties. */
|
|
getProps() {
|
|
return Object.keys(this.descriptor.properties);
|
|
}
|
|
getJSON() {
|
|
return super.toJSON();
|
|
}
|
|
// 1.x callers corrected the discovery JSON by replacing getJSON on the object: discovery goes through it
|
|
toJSON() {
|
|
return this.getJSON();
|
|
}
|
|
}
|