registry: ThermostatController 3.2 and ThermostatController.Schedule
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>
This commit is contained in:
parent
af1489696d
commit
f555a5df70
67 changed files with 2445 additions and 58 deletions
71
dist/esm/registry/interfaces/ThermostatController.d.ts
vendored
Normal file
71
dist/esm/registry/interfaces/ThermostatController.d.ts
vendored
Normal file
|
|
@ -0,0 +1,71 @@
|
|||
import type { Schema } from "../schema.js";
|
||||
/** alexa-property-schemas.html, "ThermostatMode values". EM_HEAT, emergency heating, came with version 3.2. */
|
||||
export declare const THERMOSTAT_MODES: readonly ["AUTO", "COOL", "ECO", "EM_HEAT", "HEAT", "OFF"];
|
||||
export type ThermostatModeName = (typeof THERMOSTAT_MODES)[number];
|
||||
/**
|
||||
* Version 3.2. A thermostat declares the properties it has: targetSetpoint for a single setpoint, lowerSetpoint and
|
||||
* upperSetpoint for two, all three for a target within a range. Temperatures are reported "in the same temperature
|
||||
* scale (Celsius or Fahrenheit) that the thermostat is set to display". An error of errorTypes goes under the
|
||||
* namespace of the interface, TEMPERATURE_VALUE_OUT_OF_RANGE under Alexa
|
||||
* (alexa-thermostatcontroller-errorresponse.html).
|
||||
*/
|
||||
export declare const ThermostatController: import("../types.js").InterfaceDescriptor<{
|
||||
targetSetpoint: {
|
||||
name: string;
|
||||
value: Schema<import("../schema.js").Temperature>;
|
||||
};
|
||||
lowerSetpoint: {
|
||||
name: string;
|
||||
value: Schema<import("../schema.js").Temperature>;
|
||||
};
|
||||
upperSetpoint: {
|
||||
name: string;
|
||||
value: Schema<import("../schema.js").Temperature>;
|
||||
};
|
||||
thermostatMode: {
|
||||
name: string;
|
||||
value: import("../schema.js").EnumSchema<"ECO" | "OFF" | "AUTO" | "COOL" | "EM_HEAT" | "HEAT">;
|
||||
};
|
||||
adaptiveRecoveryStatus: {
|
||||
name: string;
|
||||
value: import("../schema.js").EnumSchema<"PREHEATING" | "PRECOOLING" | "INACTIVE">;
|
||||
note: string;
|
||||
};
|
||||
}, {
|
||||
SetTargetTemperature: {
|
||||
name: string;
|
||||
payload: Schema<import("../schema.js").InferShape<{
|
||||
targetSetpoint: import("../schema.js").OptionalSchema<import("../schema.js").Temperature>;
|
||||
lowerSetpoint: import("../schema.js").OptionalSchema<import("../schema.js").Temperature>;
|
||||
upperSetpoint: import("../schema.js").OptionalSchema<import("../schema.js").Temperature>;
|
||||
holdUntil: import("../schema.js").OptionalSchema<import("../schema.js").TimeInterval>;
|
||||
}>>;
|
||||
note: string;
|
||||
};
|
||||
AdjustTargetTemperature: {
|
||||
name: string;
|
||||
payload: Schema<import("../schema.js").InferShape<{
|
||||
targetSetpointDelta: Schema<import("../schema.js").Temperature>;
|
||||
}>>;
|
||||
};
|
||||
SetThermostatMode: {
|
||||
name: string;
|
||||
payload: Schema<import("../schema.js").InferShape<{
|
||||
thermostatMode: Schema<import("../schema.js").InferShape<{
|
||||
value: import("../schema.js").EnumSchema<"ECO" | "OFF" | "AUTO" | "COOL" | "EM_HEAT" | "HEAT">;
|
||||
}>>;
|
||||
}>>;
|
||||
};
|
||||
ResumeSchedule: {
|
||||
name: string;
|
||||
payload: Schema<import("../schema.js").InferShape<{}>>;
|
||||
note: string;
|
||||
};
|
||||
}, import("../schema.js").InferShape<{
|
||||
/** Default: HEAT, COOL, AUTO, OFF. */
|
||||
supportedModes: import("../schema.js").OptionalSchema<("ECO" | "OFF" | "AUTO" | "COOL" | "EM_HEAT" | "HEAT")[]>;
|
||||
/** The user can set a temperature for a time: SetTargetTemperature comes with holdUntil. Default: false. */
|
||||
supportsScheduling: import("../schema.js").OptionalSchema<boolean>;
|
||||
/** The properties the thermostat has. Default: the three setpoints and thermostatMode. */
|
||||
properties: import("../schema.js").OptionalSchema<("targetSetpoint" | "lowerSetpoint" | "upperSetpoint" | "thermostatMode" | "adaptiveRecoveryStatus")[]>;
|
||||
}>, false>;
|
||||
94
dist/esm/registry/interfaces/ThermostatController.js
vendored
Normal file
94
dist/esm/registry/interfaces/ThermostatController.js
vendored
Normal file
|
|
@ -0,0 +1,94 @@
|
|||
import { mismatch, s } from "../schema.js";
|
||||
import { DeclarationError, defineInterface } from "../types.js";
|
||||
/** alexa-property-schemas.html, "ThermostatMode values". EM_HEAT, emergency heating, came with version 3.2. */
|
||||
export const THERMOSTAT_MODES = ["AUTO", "COOL", "ECO", "EM_HEAT", "HEAT", "OFF"];
|
||||
const PROPERTIES = ["targetSetpoint", "lowerSetpoint", "upperSetpoint", "thermostatMode", "adaptiveRecoveryStatus"];
|
||||
// What 1.x announced for every thermostat. A declaration that leaves an option out announces the same.
|
||||
const MODES_OF_1X = ["HEAT", "COOL", "AUTO", "OFF"];
|
||||
const PROPERTIES_OF_1X = ["targetSetpoint", "lowerSetpoint", "upperSetpoint", "thermostatMode"];
|
||||
const setpoints = s.object({
|
||||
targetSetpoint: s.optional(s.temperature()),
|
||||
lowerSetpoint: s.optional(s.temperature()),
|
||||
upperSetpoint: s.optional(s.temperature()),
|
||||
holdUntil: s.optional(s.timeInterval()),
|
||||
});
|
||||
// One setpoint for a thermostat that holds a temperature, the lower and the upper for one that holds a range, all
|
||||
// three for one that aims at a temperature within a range. The page marks each as not required; a payload without
|
||||
// any sets nothing.
|
||||
const setTargetTemperature = {
|
||||
expects: "one or more of targetSetpoint, lowerSetpoint, upperSetpoint",
|
||||
parse(input, path = "") {
|
||||
const payload = setpoints.parse(input, path);
|
||||
if (!payload.targetSetpoint && !payload.lowerSetpoint && !payload.upperSetpoint)
|
||||
throw mismatch(path, this.expects, input);
|
||||
return payload;
|
||||
},
|
||||
};
|
||||
/**
|
||||
* Version 3.2. A thermostat declares the properties it has: targetSetpoint for a single setpoint, lowerSetpoint and
|
||||
* upperSetpoint for two, all three for a target within a range. Temperatures are reported "in the same temperature
|
||||
* scale (Celsius or Fahrenheit) that the thermostat is set to display". An error of errorTypes goes under the
|
||||
* namespace of the interface, TEMPERATURE_VALUE_OUT_OF_RANGE under Alexa
|
||||
* (alexa-thermostatcontroller-errorresponse.html).
|
||||
*/
|
||||
export const ThermostatController = defineInterface({
|
||||
namespace: "Alexa.ThermostatController",
|
||||
version: "3.2",
|
||||
doc: "https://developer.amazon.com/docs/alexaplus/device-apis/alexa-thermostatcontroller.html",
|
||||
kind: "controller",
|
||||
tier: 1,
|
||||
instanced: false,
|
||||
properties: {
|
||||
targetSetpoint: { name: "targetSetpoint", value: s.temperature() },
|
||||
lowerSetpoint: { name: "lowerSetpoint", value: s.temperature() },
|
||||
upperSetpoint: { name: "upperSetpoint", value: s.temperature() },
|
||||
thermostatMode: { name: "thermostatMode", value: s.enum(...THERMOSTAT_MODES) },
|
||||
adaptiveRecoveryStatus: {
|
||||
name: "adaptiveRecoveryStatus",
|
||||
value: s.enum("PREHEATING", "PRECOOLING", "INACTIVE"),
|
||||
note: "heating or cooling ahead of an entry of the schedule, of Alexa.ThermostatController.Schedule",
|
||||
},
|
||||
},
|
||||
directives: {
|
||||
SetTargetTemperature: {
|
||||
name: "SetTargetTemperature",
|
||||
payload: setTargetTemperature,
|
||||
note: "holdUntil comes only to a thermostat declared with supportsScheduling",
|
||||
},
|
||||
AdjustTargetTemperature: { name: "AdjustTargetTemperature", payload: s.object({ targetSetpointDelta: s.temperature() }) },
|
||||
SetThermostatMode: {
|
||||
name: "SetThermostatMode",
|
||||
payload: s.object({ thermostatMode: s.object({ value: s.enum(...THERMOSTAT_MODES) }) }),
|
||||
},
|
||||
ResumeSchedule: { name: "ResumeSchedule", payload: s.object({}), note: "en-US only" },
|
||||
},
|
||||
options: s.object({
|
||||
/** Default: HEAT, COOL, AUTO, OFF. */
|
||||
supportedModes: s.optional(s.array(s.enum(...THERMOSTAT_MODES), { min: 1 })),
|
||||
/** The user can set a temperature for a time: SetTargetTemperature comes with holdUntil. Default: false. */
|
||||
supportsScheduling: s.optional(s.boolean()),
|
||||
/** The properties the thermostat has. Default: the three setpoints and thermostatMode. */
|
||||
properties: s.optional(s.array(s.enum(...PROPERTIES), { min: 1 })),
|
||||
}, { unknownKeys: "reject" }),
|
||||
discovery({ options: { supportedModes = MODES_OF_1X, supportsScheduling = false, properties = PROPERTIES_OF_1X } }) {
|
||||
return { supported: properties, configuration: { supportedModes, supportsScheduling } };
|
||||
},
|
||||
validate(capability) {
|
||||
const { supportedModes = MODES_OF_1X, properties = PROPERTIES_OF_1X } = capability.options;
|
||||
// alexa-thermostatcontroller.html, "Configuration object": "You must include at least one of HEAT or COOL"
|
||||
if (!supportedModes.includes("HEAT") && !supportedModes.includes("COOL")) {
|
||||
throw new DeclarationError(capability, `supportedModes ${supportedModes.join(", ")} has neither HEAT nor COOL, Alexa wants one`);
|
||||
}
|
||||
const lists = [supportedModes, properties];
|
||||
for (const list of lists) {
|
||||
const twice = list.find((entry, i) => list.indexOf(entry) !== i);
|
||||
if (twice)
|
||||
throw new DeclarationError(capability, `${twice} is listed twice`);
|
||||
}
|
||||
},
|
||||
errorNamespace: "Alexa.ThermostatController",
|
||||
errorTypes: [
|
||||
"DUAL_SETPOINTS_UNSUPPORTED", "REQUESTED_SETPOINTS_TOO_CLOSE", "THERMOSTAT_IS_OFF", "TRIPLE_SETPOINTS_UNSUPPORTED",
|
||||
"UNSUPPORTED_THERMOSTAT_MODE", "UNWILLING_TO_SET_SCHEDULE", "UNWILLING_TO_SET_VALUE",
|
||||
],
|
||||
});
|
||||
142
dist/esm/registry/interfaces/ThermostatControllerSchedule.d.ts
vendored
Normal file
142
dist/esm/registry/interfaces/ThermostatControllerSchedule.d.ts
vendored
Normal file
|
|
@ -0,0 +1,142 @@
|
|||
/**
|
||||
* Version 3.2. The schedule a user writes in the Alexa app: the interface has no utterances. Discovery lists
|
||||
* adaptiveRecoveryEnabled for a thermostat declared with supportsAdaptiveRecovery, and Alexa sends
|
||||
* SetAdaptiveRecovery to such a thermostat only.
|
||||
*/
|
||||
export declare const ThermostatControllerSchedule: import("../types.js").InterfaceDescriptor<{
|
||||
adaptiveRecoveryEnabled: {
|
||||
name: string;
|
||||
value: import("../schema.js").Schema<boolean>;
|
||||
};
|
||||
scheduleEnabled: {
|
||||
name: string;
|
||||
value: import("../schema.js").Schema<boolean>;
|
||||
};
|
||||
}, {
|
||||
SetWeeklySchedule: {
|
||||
name: string;
|
||||
payload: import("../schema.js").Schema<import("../schema.js").InferShape<{
|
||||
weeklySchedule: import("../schema.js").OptionalSchema<import("../schema.js").InferShape<{
|
||||
temperatureScale: import("../schema.js").EnumSchema<"CELSIUS" | "FAHRENHEIT" | "KELVIN">;
|
||||
Monday: import("../schema.js").Schema<import("../schema.js").InferShape<{
|
||||
startTimeInMinutes: import("../schema.js").Schema<number>;
|
||||
setpoints: import("../schema.js").Schema<import("../schema.js").InferShape<{
|
||||
upperSetpoint: import("../schema.js").OptionalSchema<import("../schema.js").Temperature>;
|
||||
lowerSetpoint: import("../schema.js").OptionalSchema<import("../schema.js").Temperature>;
|
||||
}>>;
|
||||
/** Without a mode the fan runs as the manufacturer set it. */
|
||||
fanSetting: import("../schema.js").OptionalSchema<import("../schema.js").InferShape<{
|
||||
mode: import("../schema.js").OptionalSchema<"ON" | "AUTO" | "CIRCULATE">;
|
||||
}>>;
|
||||
activityType: import("../schema.js").OptionalSchema<import("../schema.js").InferShape<{
|
||||
type: import("../schema.js").EnumSchema<"AWAY" | "HOME" | "SLEEP">;
|
||||
}>>;
|
||||
}>[]>;
|
||||
Tuesday: import("../schema.js").Schema<import("../schema.js").InferShape<{
|
||||
startTimeInMinutes: import("../schema.js").Schema<number>;
|
||||
setpoints: import("../schema.js").Schema<import("../schema.js").InferShape<{
|
||||
upperSetpoint: import("../schema.js").OptionalSchema<import("../schema.js").Temperature>;
|
||||
lowerSetpoint: import("../schema.js").OptionalSchema<import("../schema.js").Temperature>;
|
||||
}>>;
|
||||
/** Without a mode the fan runs as the manufacturer set it. */
|
||||
fanSetting: import("../schema.js").OptionalSchema<import("../schema.js").InferShape<{
|
||||
mode: import("../schema.js").OptionalSchema<"ON" | "AUTO" | "CIRCULATE">;
|
||||
}>>;
|
||||
activityType: import("../schema.js").OptionalSchema<import("../schema.js").InferShape<{
|
||||
type: import("../schema.js").EnumSchema<"AWAY" | "HOME" | "SLEEP">;
|
||||
}>>;
|
||||
}>[]>;
|
||||
Wednesday: import("../schema.js").Schema<import("../schema.js").InferShape<{
|
||||
startTimeInMinutes: import("../schema.js").Schema<number>;
|
||||
setpoints: import("../schema.js").Schema<import("../schema.js").InferShape<{
|
||||
upperSetpoint: import("../schema.js").OptionalSchema<import("../schema.js").Temperature>;
|
||||
lowerSetpoint: import("../schema.js").OptionalSchema<import("../schema.js").Temperature>;
|
||||
}>>;
|
||||
/** Without a mode the fan runs as the manufacturer set it. */
|
||||
fanSetting: import("../schema.js").OptionalSchema<import("../schema.js").InferShape<{
|
||||
mode: import("../schema.js").OptionalSchema<"ON" | "AUTO" | "CIRCULATE">;
|
||||
}>>;
|
||||
activityType: import("../schema.js").OptionalSchema<import("../schema.js").InferShape<{
|
||||
type: import("../schema.js").EnumSchema<"AWAY" | "HOME" | "SLEEP">;
|
||||
}>>;
|
||||
}>[]>;
|
||||
Thursday: import("../schema.js").Schema<import("../schema.js").InferShape<{
|
||||
startTimeInMinutes: import("../schema.js").Schema<number>;
|
||||
setpoints: import("../schema.js").Schema<import("../schema.js").InferShape<{
|
||||
upperSetpoint: import("../schema.js").OptionalSchema<import("../schema.js").Temperature>;
|
||||
lowerSetpoint: import("../schema.js").OptionalSchema<import("../schema.js").Temperature>;
|
||||
}>>;
|
||||
/** Without a mode the fan runs as the manufacturer set it. */
|
||||
fanSetting: import("../schema.js").OptionalSchema<import("../schema.js").InferShape<{
|
||||
mode: import("../schema.js").OptionalSchema<"ON" | "AUTO" | "CIRCULATE">;
|
||||
}>>;
|
||||
activityType: import("../schema.js").OptionalSchema<import("../schema.js").InferShape<{
|
||||
type: import("../schema.js").EnumSchema<"AWAY" | "HOME" | "SLEEP">;
|
||||
}>>;
|
||||
}>[]>;
|
||||
Friday: import("../schema.js").Schema<import("../schema.js").InferShape<{
|
||||
startTimeInMinutes: import("../schema.js").Schema<number>;
|
||||
setpoints: import("../schema.js").Schema<import("../schema.js").InferShape<{
|
||||
upperSetpoint: import("../schema.js").OptionalSchema<import("../schema.js").Temperature>;
|
||||
lowerSetpoint: import("../schema.js").OptionalSchema<import("../schema.js").Temperature>;
|
||||
}>>;
|
||||
/** Without a mode the fan runs as the manufacturer set it. */
|
||||
fanSetting: import("../schema.js").OptionalSchema<import("../schema.js").InferShape<{
|
||||
mode: import("../schema.js").OptionalSchema<"ON" | "AUTO" | "CIRCULATE">;
|
||||
}>>;
|
||||
activityType: import("../schema.js").OptionalSchema<import("../schema.js").InferShape<{
|
||||
type: import("../schema.js").EnumSchema<"AWAY" | "HOME" | "SLEEP">;
|
||||
}>>;
|
||||
}>[]>;
|
||||
Saturday: import("../schema.js").Schema<import("../schema.js").InferShape<{
|
||||
startTimeInMinutes: import("../schema.js").Schema<number>;
|
||||
setpoints: import("../schema.js").Schema<import("../schema.js").InferShape<{
|
||||
upperSetpoint: import("../schema.js").OptionalSchema<import("../schema.js").Temperature>;
|
||||
lowerSetpoint: import("../schema.js").OptionalSchema<import("../schema.js").Temperature>;
|
||||
}>>;
|
||||
/** Without a mode the fan runs as the manufacturer set it. */
|
||||
fanSetting: import("../schema.js").OptionalSchema<import("../schema.js").InferShape<{
|
||||
mode: import("../schema.js").OptionalSchema<"ON" | "AUTO" | "CIRCULATE">;
|
||||
}>>;
|
||||
activityType: import("../schema.js").OptionalSchema<import("../schema.js").InferShape<{
|
||||
type: import("../schema.js").EnumSchema<"AWAY" | "HOME" | "SLEEP">;
|
||||
}>>;
|
||||
}>[]>;
|
||||
Sunday: import("../schema.js").Schema<import("../schema.js").InferShape<{
|
||||
startTimeInMinutes: import("../schema.js").Schema<number>;
|
||||
setpoints: import("../schema.js").Schema<import("../schema.js").InferShape<{
|
||||
upperSetpoint: import("../schema.js").OptionalSchema<import("../schema.js").Temperature>;
|
||||
lowerSetpoint: import("../schema.js").OptionalSchema<import("../schema.js").Temperature>;
|
||||
}>>;
|
||||
/** Without a mode the fan runs as the manufacturer set it. */
|
||||
fanSetting: import("../schema.js").OptionalSchema<import("../schema.js").InferShape<{
|
||||
mode: import("../schema.js").OptionalSchema<"ON" | "AUTO" | "CIRCULATE">;
|
||||
}>>;
|
||||
activityType: import("../schema.js").OptionalSchema<import("../schema.js").InferShape<{
|
||||
type: import("../schema.js").EnumSchema<"AWAY" | "HOME" | "SLEEP">;
|
||||
}>>;
|
||||
}>[]>;
|
||||
}>>;
|
||||
}>>;
|
||||
note: string;
|
||||
};
|
||||
SetScheduleState: {
|
||||
name: string;
|
||||
payload: import("../schema.js").Schema<import("../schema.js").InferShape<{
|
||||
scheduleEnabled: import("../schema.js").Schema<boolean>;
|
||||
}>>;
|
||||
note: string;
|
||||
};
|
||||
SetAdaptiveRecovery: {
|
||||
name: string;
|
||||
payload: import("../schema.js").Schema<import("../schema.js").InferShape<{
|
||||
adaptiveRecoveryEnabled: import("../schema.js").Schema<boolean>;
|
||||
}>>;
|
||||
when: ({ options }: import("../types.js").Declared<any>) => boolean;
|
||||
};
|
||||
}, import("../schema.js").InferShape<{
|
||||
supportedFanModes: import("../schema.js").Schema<("ON" | "AUTO" | "CIRCULATE")[]>;
|
||||
/** The thermostat heats or cools ahead of an entry, to be at its temperature when it starts. */
|
||||
supportsAdaptiveRecovery: import("../schema.js").Schema<boolean>;
|
||||
maxEntryPerDay: import("../schema.js").OptionalSchema<number>;
|
||||
}>, false>;
|
||||
77
dist/esm/registry/interfaces/ThermostatControllerSchedule.js
vendored
Normal file
77
dist/esm/registry/interfaces/ThermostatControllerSchedule.js
vendored
Normal file
|
|
@ -0,0 +1,77 @@
|
|||
import { s } from "../schema.js";
|
||||
import { defineInterface } from "../types.js";
|
||||
const FAN_MODES = ["ON", "AUTO", "CIRCULATE"];
|
||||
// alexa-thermostatcontroller-schedule.html, "ScheduleEntry object": an entry ends where the next one starts
|
||||
const entry = s.object({
|
||||
startTimeInMinutes: s.number({ min: 0, max: 1439, integer: true }),
|
||||
setpoints: s.object({ upperSetpoint: s.optional(s.temperature()), lowerSetpoint: s.optional(s.temperature()) }),
|
||||
/** Without a mode the fan runs as the manufacturer set it. */
|
||||
fanSetting: s.optional(s.object({ mode: s.optional(s.enum(...FAN_MODES)) })),
|
||||
activityType: s.optional(s.object({ type: s.enum("AWAY", "HOME", "SLEEP") })),
|
||||
});
|
||||
const day = s.array(entry);
|
||||
// Same page, "WeeklySchedule object"
|
||||
const weeklySchedule = s.object({
|
||||
temperatureScale: s.enum("CELSIUS", "FAHRENHEIT", "KELVIN"),
|
||||
Monday: day,
|
||||
Tuesday: day,
|
||||
Wednesday: day,
|
||||
Thursday: day,
|
||||
Friday: day,
|
||||
Saturday: day,
|
||||
Sunday: day,
|
||||
});
|
||||
/**
|
||||
* Version 3.2. The schedule a user writes in the Alexa app: the interface has no utterances. Discovery lists
|
||||
* adaptiveRecoveryEnabled for a thermostat declared with supportsAdaptiveRecovery, and Alexa sends
|
||||
* SetAdaptiveRecovery to such a thermostat only.
|
||||
*/
|
||||
export const ThermostatControllerSchedule = defineInterface({
|
||||
namespace: "Alexa.ThermostatController.Schedule",
|
||||
version: "3.2",
|
||||
doc: "https://developer.amazon.com/docs/alexaplus/device-apis/alexa-thermostatcontroller-schedule.html",
|
||||
kind: "controller",
|
||||
tier: 2,
|
||||
instanced: false,
|
||||
properties: {
|
||||
adaptiveRecoveryEnabled: { name: "adaptiveRecoveryEnabled", value: s.boolean() },
|
||||
scheduleEnabled: { name: "scheduleEnabled", value: s.boolean() },
|
||||
},
|
||||
directives: {
|
||||
SetWeeklySchedule: {
|
||||
name: "SetWeeklySchedule",
|
||||
payload: s.object({ weeklySchedule: s.optional(weeklySchedule) }),
|
||||
note: "a schedule the thermostat cannot keep leaves the one it has and is answered with an error",
|
||||
},
|
||||
SetScheduleState: {
|
||||
name: "SetScheduleState",
|
||||
payload: s.object({ scheduleEnabled: s.boolean() }),
|
||||
note: "a disabled schedule is kept: the user can enable it again",
|
||||
},
|
||||
SetAdaptiveRecovery: {
|
||||
name: "SetAdaptiveRecovery",
|
||||
payload: s.object({ adaptiveRecoveryEnabled: s.boolean() }),
|
||||
when: ({ options }) => options.supportsAdaptiveRecovery === true,
|
||||
},
|
||||
},
|
||||
options: s.object({
|
||||
supportedFanModes: s.array(s.enum(...FAN_MODES)),
|
||||
/** The thermostat heats or cools ahead of an entry, to be at its temperature when it starts. */
|
||||
supportsAdaptiveRecovery: s.boolean(),
|
||||
maxEntryPerDay: s.optional(s.number({ min: 1, integer: true })),
|
||||
}, { unknownKeys: "reject" }),
|
||||
// A capability declared the 1.x way has none of the options; check() says so, discovery lists what there is
|
||||
discovery({ options: { supportedFanModes, supportsAdaptiveRecovery, maxEntryPerDay } }) {
|
||||
const configuration = {
|
||||
...(supportedFanModes && { supportedFanModes }),
|
||||
...(supportsAdaptiveRecovery !== undefined && { supportsAdaptiveRecovery }),
|
||||
...(maxEntryPerDay !== undefined && { maxEntryPerDay }),
|
||||
};
|
||||
return {
|
||||
supported: supportsAdaptiveRecovery ? ["adaptiveRecoveryEnabled", "scheduleEnabled"] : ["scheduleEnabled"],
|
||||
...(Object.keys(configuration).length > 0 && { configuration }),
|
||||
};
|
||||
},
|
||||
errorNamespace: "Alexa.ThermostatController.Schedule",
|
||||
errorTypes: ["INSUFFICIENT_SPACE"],
|
||||
});
|
||||
7
dist/esm/registry/interfaces/stubs.js
vendored
7
dist/esm/registry/interfaces/stubs.js
vendored
|
|
@ -56,10 +56,8 @@ const TABLE = [
|
|||
["Alexa.SmartVision.SnapshotProvider", "1", [], "alexa-smartvision-snapshotprovider.html"],
|
||||
["Alexa.Speaker", "1", [], "alexa-speaker.html"],
|
||||
["Alexa.StepSpeaker", "1", [], "alexa-stepspeaker.html"],
|
||||
["Alexa.ThermostatController", "3.2", ["targetSetpoint", "lowerSetpoint", "upperSetpoint", "thermostatMode"], "alexa-thermostatcontroller.html"],
|
||||
["Alexa.ThermostatController.Configuration", "1", [], "alexa-thermostatcontroller-configuration.html"],
|
||||
["Alexa.ThermostatController.HVAC.Components", "1", [], "alexa-thermostatcontroller-hvac-components.html"],
|
||||
["Alexa.ThermostatController.Schedule", "1", [], "alexa-thermostatcontroller-schedule.html"],
|
||||
// "UNKNOWN" in 1.5.2 as well; the page is titled "Interface 3"
|
||||
["Alexa.TimeHoldController", "3", [], "alexa-timeholdcontroller.html"],
|
||||
["Alexa.UIController", "1", [], "alexa-uicontroller.html"],
|
||||
|
|
@ -67,16 +65,13 @@ const TABLE = [
|
|||
["Alexa.VideoRecorder", "1", [], "alexa-videorecorder.html"],
|
||||
["Alexa.WakeOnLANController", "1", [], "alexa-wakeonlancontroller.html"],
|
||||
];
|
||||
// What 1.5.2 added to the capability object of two of them
|
||||
// What 1.5.2 added to the capability object of one of them
|
||||
const EXTRAS = {
|
||||
// No properties object; supportsDeactivation and proactivelyReported on the capability itself
|
||||
"Alexa.SceneController": ({ proactivelyReported }) => ({
|
||||
properties: false,
|
||||
topLevel: { supportsDeactivation: true, proactivelyReported },
|
||||
}),
|
||||
"Alexa.ThermostatController": () => ({
|
||||
configuration: { supportedModes: ["HEAT", "COOL", "AUTO", "OFF"], supportsScheduling: false },
|
||||
}),
|
||||
};
|
||||
function kindOf(namespace) {
|
||||
if (namespace.endsWith("Sensor"))
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue