messages: DoorbellPress is sent with the empty context of its page

proactiveEvent() built every proactive event without a context, so doorbellPress() and
device.raise(DoorbellEventSource, "DoorbellPress") left out the "context": {} that the example of
alexa-doorbelleventsource.html has. The Event of Alexa.SimpleEventSource is printed without one, so
the event descriptor says which it is (emptyContext) and raise() passes it on to the builder.

A raised DoorbellPress is now { event, context: {} }, 13 bytes longer; the Event of a button is
unchanged. The tests compare the keys and the context of the built message with the fixture of the
page, for the builder, the descriptor and raise(). 267 tests pass.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
David 2026-09-28 21:08:10 +00:00
parent 3a07c861b1
commit 4a3dd81bcf
20 changed files with 86 additions and 18 deletions

View file

@ -88,8 +88,14 @@ export interface ProactiveEventFields extends Envelope {
/** Default: "3". */
payloadVersion?: string;
payload: Record<string, unknown>;
/** true: the message has "context": {}, as the page of the event prints it. Default: no context. */
emptyContext?: boolean;
}
/** An event a device raises by itself, of any interface. The header has no correlationToken: nobody asked. */
/**
* An event a device raises by itself, of any interface. The header has no correlationToken: nobody asked. The
* pages differ on the context, so the caller says which it is: DoorbellPress is printed with an empty one
* (alexa-doorbelleventsource.html), the Event of Alexa.SimpleEventSource without.
*/
export declare function proactiveEvent(fields: ProactiveEventFields): ProactiveEventMessage;
export interface DoorbellPressFields extends Envelope {
/** Default: "PHYSICAL_INTERACTION", somebody pressed the button. */

View file

@ -73,4 +73,6 @@ export interface SceneEventMessage {
/** An event a device raises by itself: DoorbellPress, the Event of Alexa.SimpleEventSource. */
export interface ProactiveEventMessage {
event: Event;
/** Only with an event whose page prints it: DoorbellPress has an empty one, the Event of a button has none. */
context?: {};
}