/** * @license * Copyright 2022-2026 Matter.js Authors * SPDX-License-Identifier: Apache-2.0 */ import { Interactable, InteractionSession } from "#action/Interactable.js"; import { NodeProtocol } from "#action/protocols.js"; import { Invoke } from "#action/request/Invoke.js"; import { Read } from "#action/request/Read.js"; import { Subscribe } from "#action/request/Subscribe.js"; import { Write } from "#action/request/Write.js"; import { InvokeResult } from "#action/response/InvokeResult.js"; import { ReadResult } from "#action/response/ReadResult.js"; import { SubscribeResult } from "#action/response/SubscribeResult.js"; import { WriteResult } from "#action/response/WriteResult.js"; import { CommandInvokeResponse } from "#action/server/CommandInvokeResponse.js"; import { EventReadResponse } from "#action/server/EventReadResponse.js"; import { Logger, NotImplementedError } from "@matter/general"; import { AttributeReadResponse } from "./AttributeReadResponse.js"; import { AttributeWriteResponse } from "./AttributeWriteResponse.js"; const logger = Logger.get("ServerInteraction"); /** * Implementation of server interaction. * * This implementation currently focuses on read of attribute data with other actions to be implemented later. Until * completion there will be redundancy with other components including: * * - InteractionServer (significant overlap with this class) */ export class ServerInteraction< SessionT extends InteractionSession = InteractionSession, > implements Interactable { #node: NodeProtocol; #writeOptions?: AttributeWriteResponse.Options; constructor(node: NodeProtocol, writeOptions?: AttributeWriteResponse.Options) { this.#node = node; this.#writeOptions = writeOptions; } async *read(request: Read, session: SessionT): ReadResult { // TODO - validate request let readInfo = ""; if (Read.containsAttribute(request)) { const attributeReader = new AttributeReadResponse(this.#node, session); yield* attributeReader.process(request); const { existent, status, success } = attributeReader.counts; readInfo = `${existent} matching attributes (${status ? `${status} status` : ""}${success ? `${success} values` : ""})`; } if (Read.containsEvent(request)) { const eventReader = new EventReadResponse(this.#node, session); yield* eventReader.process(request); const { existent, status, success } = eventReader.counts; readInfo += `${readInfo.length > 0 ? ", " : ""}${existent} matching events (${status ? `${status} status, ` : ""}${success ? `${success} values` : ""})`; } logger.debug(`Read request resolved to ${readInfo}`); } subscribe(_request: Subscribe, _session?: SessionT): SubscribeResult { // TODO throw new NotImplementedError(); } async write(request: T, session: SessionT): WriteResult { // TODO - validate request const writer = new AttributeWriteResponse(this.#node, session, this.#writeOptions); return (await writer.process(request)) as Awaited>; } async *invoke(request: Invoke, session: SessionT): InvokeResult { // TODO - validate request const invoker = new CommandInvokeResponse(this.#node, session); yield* invoker.process(request); } }