David
f555a5df70
The thermostat is described from its page: one, two or three setpoints with holdUntil, AdjustTargetTemperature, SetThermostatMode with the six modes (EM_HEAT is new), ResumeSchedule, adaptiveRecoveryStatus, and its seven error types under Alexa.ThermostatController. A declaration gives supportedModes, supportsScheduling and the properties the device has; without them discovery is what 1.5.2 sent: HEAT, COOL, AUTO, OFF and the three setpoints with thermostatMode. supportedModes without HEAT or COOL is refused where it is declared. ThermostatController.Schedule replaces its stub. Wire change for a 1.x declaration of it: version 3.2 (was 1) and scheduleEnabled listed (was nothing). SetAdaptiveRecovery is taken only with supportsAdaptiveRecovery. 24 examples of three pages are saved as fixtures; the page folds the SetWeeklySchedule example away, its payload is tested from the tables. 207 tests pass, 191 before. Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
80 lines
3.7 KiB
JavaScript
80 lines
3.7 KiB
JavaScript
import { s } from "../registry/schema.js";
|
|
import { DeclarationError } from "../registry/types.js";
|
|
/** The same as a schema. The friendly names are checked with the instance, by the rules of the interface. */
|
|
export const commonOptions = s.object({
|
|
instance: s.optional(s.string()),
|
|
friendlyNames: s.optional(s.array(s.unknown())),
|
|
retrievable: s.optional(s.boolean()),
|
|
proactivelyReported: s.optional(s.boolean()),
|
|
nonControllable: s.optional(s.boolean()),
|
|
});
|
|
/** One interface as an endpoint declares it: the descriptor, and what the declaration says about this endpoint. */
|
|
export class Capability {
|
|
constructor(descriptor, declared) {
|
|
this.descriptor = descriptor;
|
|
/** The endpoint the capability is declared on; the device sets it. */
|
|
this.endpointId = "";
|
|
/** What the bridge logs about the declaration, once, when it answers a discovery. */
|
|
this.notes = [];
|
|
this.handlers = new Map();
|
|
this.instance = declared.instance ?? "";
|
|
this.friendlyNames = declared.friendlyNames ?? [];
|
|
this.retrievable = declared.retrievable ?? true;
|
|
this.proactivelyReported = declared.proactivelyReported ?? false;
|
|
this.nonControllable = declared.nonControllable;
|
|
this.options = declared.options;
|
|
}
|
|
get namespace() {
|
|
return this.descriptor.namespace;
|
|
}
|
|
on(name, handler) {
|
|
const names = Object.keys(this.descriptor.directives);
|
|
// An interface the library only names (tier 3) describes no directive: any name is taken
|
|
if (name !== "*" && this.descriptor.tier !== 3 && !names.includes(name)) {
|
|
throw new DeclarationError(this, `${name} is not a directive of the interface, which has ${names.join(", ") || "none"}`);
|
|
}
|
|
if (typeof handler !== "function")
|
|
throw new DeclarationError(this, `the handler of ${name} is a function`);
|
|
this.handlers.set(name, handler);
|
|
return this;
|
|
}
|
|
/** The handler on(name) registered, or the one of "*". */
|
|
handlerFor(name) {
|
|
return this.handlers.get(name) ?? this.handlers.get("*");
|
|
}
|
|
/** Mappings of "open", "close", "raise", "lower" and of states, when the declaration has any. */
|
|
get semantics() {
|
|
const { semantics } = this.options;
|
|
const mapped = (semantics?.actionMappings?.length ?? 0) + (semantics?.stateMappings?.length ?? 0);
|
|
return mapped > 0 ? semantics : undefined;
|
|
}
|
|
/** The capability object for discovery, its fields in the order of the example on alexa-discovery-objects.html. */
|
|
toJSON() {
|
|
const { descriptor, semantics } = this;
|
|
const extras = descriptor.discovery ? descriptor.discovery(this) : {};
|
|
const json = {
|
|
type: "AlexaInterface",
|
|
interface: descriptor.namespace,
|
|
...(this.instance ? { instance: this.instance } : {}),
|
|
version: descriptor.version,
|
|
};
|
|
if (extras.properties !== false) {
|
|
json.properties = {
|
|
supported: (extras.supported ?? Object.keys(descriptor.properties)).map((name) => ({ name })),
|
|
proactivelyReported: this.proactivelyReported,
|
|
retrievable: this.retrievable,
|
|
};
|
|
if (this.nonControllable !== undefined)
|
|
json.properties.nonControllable = this.nonControllable;
|
|
}
|
|
if (this.friendlyNames.length > 0)
|
|
json.capabilityResources = { friendlyNames: this.friendlyNames };
|
|
if (extras.configuration)
|
|
json.configuration = extras.configuration;
|
|
if (extras.configurations)
|
|
json.configurations = extras.configurations;
|
|
if (semantics)
|
|
json.semantics = semantics;
|
|
return { ...json, ...extras.topLevel };
|
|
}
|
|
}
|