registry: SceneController events, DoorbellEventSource, SimpleEventSource, TimeHoldController, InventoryLevelSensor, WakeOnLANController

Six descriptors written from their pages replace the last stubs of tiers 1 and 2. A scene answers Activate and
Deactivate through ctx.respond() with ActivationStarted and DeactivationStarted, the time and the cause filled
in. device.raise(descriptor, name, payload) publishes DoorbellPress and the Event of a button on <root>/event
with the endpoint and a new messageId; it throws a MessageError for an interface or instance the device did
not declare, an event that answers a directive, a payload that does not fit and a message over 16000 bytes.
TurnOn of a device with WakeOnLANController is deferred without the warning.

On the wire: a doorbell has no properties object and proactivelyReported on the capability; SimpleEventSource
is version 1.0, InventoryLevelSensor and WakeOnLANController version 3 (1.5.2: 1). A scene declared without
options is announced as before. Alex2MQTT has no topic yet for the WakeUp event.
24 examples of the six pages are saved as fixtures. 267 tests pass, 241 before.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>

dist/cjs/registry/interfaces/WakeOnLANController.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WakeOnLANController = void 0;
+const schema_js_1 = require("../schema.js");
+const types_js_1 = require("../types.js");
+// 00-14-22-01-23-45 in the example of the page; the colon is the other common way to write one
+const MAC_ADDRESS = /^[0-9A-Fa-f]{2}([-:][0-9A-Fa-f]{2}){5}$/;
+/**
+ * A device that is switched on by a Wake-on-LAN message, which an Echo of the user sends to the MAC addresses of
+ * the capability. The interface has no directive and no property: the device gets TurnOn of Alexa.PowerController,
+ * answers with a DeferredResponse, sends the WakeUp event and, when it is up, the Response.
+ *
+ * Alex2MQTT has no topic yet that takes the WakeUp event to Alexa.
+ */
+exports.WakeOnLANController = (0, types_js_1.defineInterface)({
+    namespace: "Alexa.WakeOnLANController",
+    version: "3",
+    doc: "https://developer.amazon.com/docs/alexaplus/device-apis/alexa-wakeonlancontroller.html",
+    kind: "controller",
+    tier: 2,
+    instanced: false,
+    properties: {},
+    directives: {},
+    events: {
+        WakeUp: { name: "WakeUp", payload: schema_js_1.s.object({}), topic: "response" },
+    },
+    options: schema_js_1.s.object({
+        macAddresses: schema_js_1.s.array(schema_js_1.s.string({ pattern: MAC_ADDRESS, expects: "a MAC address like 00-14-22-01-23-45" }), { min: 1 }),
+    }, { unknownKeys: "reject" }),
+    // The example has a properties object without fields, which topLevel puts where properties: false left none. A
+    // capability declared the 1.x way has no address; check() says so.
+    discovery: ({ options: { macAddresses } }) => ({
+        properties: false,
+        topLevel: { properties: {} },
+        ...(macAddresses && { configuration: { MACAddresses: macAddresses } }),
+    }),
+    validate(capability) {
+        const addresses = capability.options.macAddresses.map((address) => address.toUpperCase().replace(/:/g, "-"));
+        const twice = addresses.find((address, i) => addresses.indexOf(address) !== i);
+        if (twice)
+            throw new types_js_1.DeclarationError(capability, `${twice} is listed twice`);
+    },
+    deferrable: true,
+    defers: [{ namespace: "Alexa.PowerController", name: "TurnOn" }],
+});