dispatch: typed handlers, respond/defer/error, automatic ErrorResponse, watchdog
src/dispatcher.ts routes a directive to capability.on(name | "*"), device.onDirective() or device.onReportState(), with the payload checked by the descriptor of the interface. The DirectiveContext answers with respond/report/defer/error; respond() and report() start from device.state(). A handler or 1.x listener that throws or rejects is answered with INTERNAL_ERROR (an AlexaError with itself) and reported through "error", never as an unhandled rejection. Undeclared interface, unknown directive, AdjustMode on an unordered mode and a missing handler get INVALID_DIRECTIVE, a bad payload INVALID_VALUE; a device with an "Event" or "ReportState" listener keeps the answer to itself. Every answer passes the dispatcher: the first one per correlationToken is published, a second is refused. No answer within answerWithinMs (6500, 0 = off, unref'd timer) sends INTERNAL_ERROR and emits "unanswered". A messageId that arrived in the last 60 s is dropped. New: "unknownEndpoint", options answerUnknownEndpoints, publisher, timers, and bridge.receive() to run a bridge without a broker. 168 tests pass (18 new). Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
This commit is contained in:
parent
e0fe9d2812
commit
feff828ec1
40 changed files with 2149 additions and 136 deletions
26
dist/cjs/device/Device.js
vendored
26
dist/cjs/device/Device.js
vendored
|
|
@ -132,6 +132,32 @@ class Device extends events_1.EventEmitter {
|
|||
const build = () => (0, build_js_1.sceneEvent)({ endpointId: this.endpointId, correlationToken, activated, cause });
|
||||
return (0, transport_js_1.send)(this.publisher, answer(this.rootTopic, this.endpointId), build, this.onPublishError);
|
||||
}
|
||||
/**
|
||||
* How the device reports its state, every retrievable property of it:
|
||||
*
|
||||
* blinds.state((s) => s.set(lift, "rangeValue", motor.position).health("OK"));
|
||||
*
|
||||
* ReportState is answered with it, and it is the context of every ctx.respond(), where the handler sets only what
|
||||
* the directive changed. Alexa wants the whole state in both (alexa-response.html, "Synchronous response").
|
||||
*/
|
||||
state(fill) {
|
||||
this.stateProvider = fill;
|
||||
return this;
|
||||
}
|
||||
/** Answer ReportState in a handler of its own, for a state that has to be read from the device first. */
|
||||
onReportState(handler) {
|
||||
this.reportStateHandler = handler;
|
||||
return this;
|
||||
}
|
||||
/** The handler for the directives of declared capabilities that have no handler of their own. */
|
||||
onDirective(handler) {
|
||||
this.directiveHandler = handler;
|
||||
return this;
|
||||
}
|
||||
/** The capability declared for the interface, under the instance for a generic controller. */
|
||||
capability(namespace, instance = "") {
|
||||
return this.capabilities.find((capability) => capability.namespace === namespace && capability.instance === instance);
|
||||
}
|
||||
/** The capabilities the device declared, in the order it declared them. */
|
||||
getCapabilities() {
|
||||
return this.capabilities.slice();
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue