David
feff828ec1
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>
37 lines
2.3 KiB
JavaScript
37 lines
2.3 KiB
JavaScript
"use strict";
|
|
// The topics of the Alex2MQTT contract, named once. The backend and Alex2ESP use the same names, so none of them
|
|
// can change here alone.
|
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
exports.changeReport = exports.DIRECTIVE_BUDGET_MS = exports.deferred = exports.response = exports.subscriptions = exports.directive = exports.discoverReply = exports.discover = void 0;
|
|
exports.directiveEndpoint = directiveEndpoint;
|
|
/** Where the backend asks for the endpoints of the root. */
|
|
const discover = (root) => `${root}/discover`;
|
|
exports.discover = discover;
|
|
/** Where the bridge answers a discovery request with its endpoints. */
|
|
const discoverReply = (root) => `${root}/discover_r`;
|
|
exports.discoverReply = discoverReply;
|
|
/** Where the backend publishes the directives for one endpoint. */
|
|
const directive = (root, endpointId) => `${root}/${endpointId}/alexaDirective`;
|
|
exports.directive = directive;
|
|
/**
|
|
* What the bridge subscribes to: the discovery requests and the directives of every endpoint. Not <root>/#, which
|
|
* also delivers what the bridge itself publishes and the backend's <endpointId>/alexaDirective_e.
|
|
*/
|
|
const subscriptions = (root) => [(0, exports.discover)(root), (0, exports.directive)(root, "+")];
|
|
exports.subscriptions = subscriptions;
|
|
/** The endpointId of a directive topic, null for any other topic. */
|
|
function directiveEndpoint(root, topic) {
|
|
const [, endpointId, ...rest] = topic.startsWith(`${root}/`) ? topic.slice(root.length).split("/") : [];
|
|
return endpointId && rest.length === 1 && rest[0] === "alexaDirective" ? endpointId : null;
|
|
}
|
|
/** Where the answer to a directive goes. "alexaResponce" is how the backend and Alex2ESP spell it. */
|
|
const response = (root, endpointId) => `${root}/${endpointId}/alexaResponce`;
|
|
exports.response = response;
|
|
/** Where the answer goes once a DeferredResponse was sent for the directive. */
|
|
const deferred = (root, endpointId) => `${root}/${endpointId}/deferredResponse`;
|
|
exports.deferred = deferred;
|
|
/** How long Alex2MQTT waits for the answer to a directive before it tells Alexa that the endpoint did not answer. */
|
|
exports.DIRECTIVE_BUDGET_MS = 7000;
|
|
/** Where every ChangeReport of the root goes: the backend adds the user's token and posts it to Alexa. */
|
|
const changeReport = (root) => `${root}/changeReport`;
|
|
exports.changeReport = changeReport;
|