@project-chip/matter.js 0.2.0 → 0.3.0

package/dist/es/protocol/interaction/InteractionClient.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MessageExchange } from "../../protocol/MessageExchange.js";
+import { ProtocolHandler } from "../../protocol/ProtocolHandler.js";
+import { MatterController } from "../../MatterController.js";
+import { StatusCode } from "./InteractionProtocol.js";
+import { TlvSchema } from "../../tlv/TlvSchema.js";
+import { DataReport } from "./InteractionMessenger.js";
+import { DecodedAttributeReportValue } from "./AttributeDataDecoder.js";
+import { NodeId } from "../../datatype/NodeId.js";
+import { Attribute, AttributeJsType, Attributes, Cluster, Command, Commands, RequestType, ResponseType } from "../../cluster/Cluster.js";
+import { ExchangeProvider } from "../ExchangeManager.js";
+import { ClusterClient } from "../../cluster/client/ClusterClient.js";
+export interface AttributeStatus {
+    path: {
+        nodeId?: NodeId;
+        endpointId?: number;
+        clusterId?: number;
+        attributeId?: number;
+    };
+    status: StatusCode;
+}
+export declare function ClusterClient<CommandT extends Commands, AttributeT extends Attributes>(interactionClient: InteractionClient, endpointId: number, clusterDef: Cluster<any, AttributeT, CommandT, any>): ClusterClient<CommandT, AttributeT>;
+export declare class SubscriptionClient implements ProtocolHandler<MatterController> {
+    private readonly subscriptionListeners;
+    constructor(subscriptionListeners: Map<number, (dataReport: DataReport) => void>);
+    getId(): number;
+    onNewExchange(exchange: MessageExchange<MatterController>): Promise<void>;
+}
+export declare class InteractionClient {
+    private readonly exchangeProvider;
+    private readonly subscriptionListeners;
+    private readonly subscribedLocalValues;
+    constructor(exchangeProvider: ExchangeProvider);
+    getAllAttributes(): Promise<DecodedAttributeReportValue[]>;
+    getMultipleAttributes(attributeRequests: {
+        endpointId?: number;
+        clusterId?: number;
+        attributeId?: number;
+    }[]): Promise<DecodedAttributeReportValue[]>;
+    get<A extends Attribute<any>>(endpointId: number, clusterId: number, attribute: A): Promise<AttributeJsType<A> | undefined>;
+    private processReadRequest;
+    set<T>(endpointId: number, clusterId: number, attribute: Attribute<T>, value: T, dataVersion?: number): Promise<void>;
+    setMultipleAttributes(attributes: {
+        endpointId: number;
+        clusterId: number;
+        attribute: Attribute<any>;
+        value: any;
+        dataVersion?: number;
+    }[]): Promise<AttributeStatus[]>;
+    subscribe<A extends Attribute<any>>(endpointId: number, clusterId: number, attribute: A, minIntervalFloorSeconds: number, maxIntervalCeilingSeconds: number, listener?: (value: AttributeJsType<A>, version: number) => void): Promise<void>;
+    subscribeMultipleAttributes(attributeRequests: {
+        endpointId?: number;
+        clusterId?: number;
+        attributeId?: number;
+    }[], minIntervalFloorSeconds: number, maxIntervalCeilingSeconds: number, listener?: (data: DecodedAttributeReportValue) => void): Promise<void>;
+    invoke<C extends Command<any, any>>(endpointId: number, clusterId: number, request: RequestType<C>, id: number, requestSchema: TlvSchema<RequestType<C>>, _responseId: number, responseSchema: TlvSchema<ResponseType<C>>, optional: boolean): Promise<ResponseType<C>>;
+    private withMessenger;
+}
+//# sourceMappingURL=InteractionClient.d.ts.map

package/dist/es/protocol/interaction/InteractionClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InteractionClient.d.ts","sourceRoot":"","sources":["../../../../src/protocol/interaction/InteractionClient.ts"],"names":[],"mappings":"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"}

package/dist/es/protocol/interaction/InteractionClient.js

@@ -0,0 +1,279 @@
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import { capitalize } from "../../util/String.js";
+import { Logger } from "../../log/Logger.js";
+import { IncomingInteractionClientMessenger, InteractionClientMessenger, StatusResponseError } from "./InteractionMessenger.js";
+import { attributePathToId, INTERACTION_PROTOCOL_ID } from "./InteractionServer.js";
+import { normalizeAndDecodeReadAttributeReport } from "./AttributeDataDecoder.js";
+import { TlvNoResponse } from "../../cluster/Cluster.js";
+const logger = Logger.get("InteractionClient");
+export function ClusterClient(interactionClient, endpointId, clusterDef) {
+    const result = {};
+    const { id: clusterId, commands, attributes } = clusterDef;
+    // Add accessors
+    for (const attributeName in attributes) {
+        const attribute = attributes[attributeName];
+        const capitalizedAttributeName = capitalize(attributeName);
+        result[`get${capitalizedAttributeName}`] = () => __awaiter(this, void 0, void 0, function* () { return interactionClient.get(endpointId, clusterId, attribute); });
+        result[`set${capitalizedAttributeName}`] = (value) => __awaiter(this, void 0, void 0, function* () { return interactionClient.set(endpointId, clusterId, attribute, value); });
+        result[`subscribe${capitalizedAttributeName}`] = (listener, minIntervalS, maxIntervalS) => __awaiter(this, void 0, void 0, function* () { return interactionClient.subscribe(endpointId, clusterId, attribute, minIntervalS, maxIntervalS, listener); });
+    }
+    // Add command calls
+    for (const commandName in commands) {
+        const { requestId, requestSchema, responseId, responseSchema, optional } = commands[commandName];
+        result[commandName] = (request) => __awaiter(this, void 0, void 0, function* () { return interactionClient.invoke(endpointId, clusterId, request, requestId, requestSchema, responseId, responseSchema, optional); });
+    }
+    return result;
+}
+export class SubscriptionClient {
+    constructor(subscriptionListeners) {
+        this.subscriptionListeners = subscriptionListeners;
+    }
+    getId() {
+        return INTERACTION_PROTOCOL_ID;
+    }
+    onNewExchange(exchange) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const messenger = new IncomingInteractionClientMessenger(exchange);
+            const dataReport = yield messenger.readDataReport();
+            const subscriptionId = dataReport.subscriptionId;
+            if (subscriptionId === undefined) {
+                yield messenger.sendStatus(125 /* StatusCode.InvalidSubscription */);
+                throw new Error("Invalid Data report without Subscription ID");
+            }
+            const listener = this.subscriptionListeners.get(subscriptionId);
+            if (listener === undefined) {
+                yield messenger.sendStatus(125 /* StatusCode.InvalidSubscription */);
+                throw new Error(`Unknown subscription ID ${subscriptionId}`);
+            }
+            yield messenger.sendStatus(0 /* StatusCode.Success */);
+            listener(dataReport);
+        });
+    }
+}
+export class InteractionClient {
+    constructor(exchangeProvider) {
+        this.exchangeProvider = exchangeProvider;
+        this.subscriptionListeners = new Map();
+        this.subscribedLocalValues = new Map();
+        // TODO: Right now we potentially add multiple handlers for the same protocol, We need to fix this
+        this.exchangeProvider.addProtocolHandler(new SubscriptionClient(this.subscriptionListeners));
+    }
+    getAllAttributes() {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.getMultipleAttributes([{ /* empty means *,*,* */}]);
+        });
+    }
+    getMultipleAttributes(attributeRequests) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.withMessenger((messenger) => __awaiter(this, void 0, void 0, function* () {
+                return yield this.processReadRequest(messenger, {
+                    attributeRequests,
+                    interactionModelRevision: 1,
+                    isFabricFiltered: true,
+                });
+            }));
+        });
+    }
+    get(endpointId, clusterId, attribute) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const { id: attributeId } = attribute;
+            const localValue = this.subscribedLocalValues.get(attributePathToId({ endpointId, clusterId, attributeId }));
+            if (localValue !== undefined) {
+                return localValue.value;
+            }
+            const response = yield this.getMultipleAttributes([{ endpointId, clusterId, attributeId }]);
+            if (response.length === 0) {
+                return undefined;
+            }
+            if (response.length > 1) {
+                throw new Error("Unexpected response with more then one attribute");
+            }
+            return response[0].value;
+        });
+    }
+    processReadRequest(messenger, request) {
+        return __awaiter(this, void 0, void 0, function* () {
+            // Send read request and combine all (potentially chunked) responses
+            let response = yield messenger.sendReadRequest(request);
+            const result = [];
+            while (true) {
+                if (response.attributeReports !== undefined) {
+                    result.push(...response.attributeReports);
+                }
+                if (!response.suppressResponse) {
+                    yield messenger.sendStatus(0 /* StatusCode.Success */);
+                }
+                if (!response.moreChunkedMessages)
+                    break;
+                response = yield messenger.readDataReport();
+            }
+            // Normalize and decode the response
+            return normalizeAndDecodeReadAttributeReport(result);
+        });
+    }
+    set(endpointId, clusterId, attribute, value, dataVersion) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.setMultipleAttributes([{ endpointId, clusterId, attribute, value, dataVersion }]);
+            // Response contains Status error if there was an error on write
+            if (response.length) {
+                const { path: { endpointId, clusterId, attributeId }, status } = response[0];
+                if (status !== undefined && status !== 0 /* StatusCode.Success */) {
+                    throw new StatusResponseError(`Error setting attribute ${endpointId}/${clusterId}/${attributeId}`, status);
+                }
+            }
+        });
+    }
+    setMultipleAttributes(attributes) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.withMessenger((messenger) => __awaiter(this, void 0, void 0, function* () {
+                const writeRequests = attributes.map(({ endpointId, clusterId, attribute: { id, schema }, value, dataVersion }) => ({
+                    path: { endpointId, clusterId, attributeId: id }, data: schema.encodeTlv(value), dataVersion
+                }));
+                const response = yield messenger.sendWriteCommand({
+                    suppressResponse: false,
+                    timedRequest: false,
+                    writeRequests,
+                    moreChunkedMessages: false,
+                    interactionModelRevision: 1,
+                });
+                if (response === undefined) {
+                    throw new Error(`No response received`);
+                }
+                return response.writeResponses.flatMap(({ status: { status, clusterStatus }, path: { nodeId, endpointId, clusterId, attributeId } }) => {
+                    var _a;
+                    return { path: { nodeId, endpointId, clusterId, attributeId }, status: (_a = status !== null && status !== void 0 ? status : clusterStatus) !== null && _a !== void 0 ? _a : 1 /* StatusCode.Failure */ };
+                }).filter(({ status }) => status !== 0 /* StatusCode.Success */);
+            }));
+        });
+    }
+    subscribe(endpointId, clusterId, attribute, minIntervalFloorSeconds, maxIntervalCeilingSeconds, listener) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.withMessenger((messenger) => __awaiter(this, void 0, void 0, function* () {
+                const { id: attributeId } = attribute;
+                const { report, subscribeResponse: { subscriptionId } } = yield messenger.sendSubscribeRequest({
+                    attributeRequests: [{ endpointId, clusterId, attributeId }],
+                    keepSubscriptions: true,
+                    minIntervalFloorSeconds,
+                    maxIntervalCeilingSeconds,
+                    isFabricFiltered: true,
+                }); // TODO: also initialize all values
+                const subscriptionListener = (dataReport) => {
+                    if (!Array.isArray(dataReport.attributeReports) || !dataReport.attributeReports.length) {
+                        logger.debug('Subscription result empty');
+                        return;
+                    }
+                    const data = normalizeAndDecodeReadAttributeReport(dataReport.attributeReports);
+                    if (data.length === 0) {
+                        throw new Error('Subscription result reporting undefined/no value not specified');
+                    }
+                    if (data.length > 1) {
+                        throw new Error("Unexpected response with more then one attribute");
+                    }
+                    const { path: { endpointId, clusterId, attributeId }, value, version } = data[0];
+                    if (value === undefined)
+                        throw new Error('Subscription result reporting undefined value not specified');
+                    this.subscribedLocalValues.set(attributePathToId({ endpointId, clusterId, attributeId }), { value, version });
+                    listener === null || listener === void 0 ? void 0 : listener(value, version);
+                };
+                this.subscriptionListeners.set(subscriptionId, subscriptionListener);
+                subscriptionListener(report);
+                return;
+            }));
+        });
+    }
+    subscribeMultipleAttributes(attributeRequests, minIntervalFloorSeconds, maxIntervalCeilingSeconds, listener) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.withMessenger((messenger) => __awaiter(this, void 0, void 0, function* () {
+                const { report, subscribeResponse: { subscriptionId } } = yield messenger.sendSubscribeRequest({
+                    attributeRequests,
+                    keepSubscriptions: true,
+                    minIntervalFloorSeconds,
+                    maxIntervalCeilingSeconds,
+                    isFabricFiltered: true,
+                }); // TODO: also initialize all values
+                const subscriptionListener = (dataReport) => {
+                    if (!Array.isArray(dataReport.attributeReports) || !dataReport.attributeReports.length) {
+                        logger.debug('Subscription result empty');
+                        return;
+                    }
+                    const values = normalizeAndDecodeReadAttributeReport(dataReport.attributeReports);
+                    values.forEach(data => {
+                        const { path: { endpointId, clusterId, attributeId }, value, version } = data;
+                        if (value === undefined)
+                            throw new Error('Subscription result reporting undefined value not specified');
+                        this.subscribedLocalValues.set(attributePathToId({ endpointId, clusterId, attributeId }), { value, version });
+                        listener === null || listener === void 0 ? void 0 : listener(data);
+                    });
+                };
+                this.subscriptionListeners.set(subscriptionId, subscriptionListener);
+                subscriptionListener(report);
+                return;
+            }));
+        });
+    }
+    invoke(endpointId, clusterId, request, id, requestSchema, _responseId, responseSchema, optional) {
+        return __awaiter(this, void 0, void 0, function* () {
+            return this.withMessenger((messenger) => __awaiter(this, void 0, void 0, function* () {
+                const commandFields = requestSchema.encodeTlv(request);
+                const invokeResponse = yield messenger.sendInvokeCommand({
+                    invokeRequests: [
+                        { commandPath: { endpointId, clusterId, commandId: id }, commandFields }
+                    ],
+                    timedRequest: false,
+                    suppressResponse: false,
+                    interactionModelRevision: 1,
+                });
+                if (invokeResponse === undefined)
+                    throw new Error("No response received");
+                const { invokeResponses } = invokeResponse;
+                if (invokeResponses.length === 0)
+                    throw new Error("No response received");
+                const { command, status } = invokeResponses[0];
+                if (status !== undefined) {
+                    const resultCode = status.status.status;
+                    if (resultCode !== 0 /* StatusCode.Success */)
+                        throw new Error(`Received non-success result: ${resultCode}`);
+                    if (responseSchema !== TlvNoResponse)
+                        throw new Error("A response was expected for this command");
+                    return undefined; // ResponseType is void, force casting the empty result
+                }
+                if (command !== undefined) {
+                    if (command.commandFields === undefined) {
+                        if (responseSchema !== TlvNoResponse)
+                            throw new Error("A response was expected for this command");
+                        return undefined; // ResponseType is void, force casting the empty result
+                    }
+                    return responseSchema.decodeTlv(command.commandFields);
+                }
+                if (optional) {
+                    return undefined; // ResponseType allows undefined for optional commands
+                }
+                throw new Error("Received invoke response with no result nor response");
+            }));
+        });
+    }
+    withMessenger(invoke) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const messenger = new InteractionClientMessenger(this.exchangeProvider);
+            try {
+                return yield invoke(messenger);
+            }
+            finally {
+                messenger.close();
+            }
+        });
+    }
+}

package/dist/es/protocol/interaction/InteractionMessenger.d.ts

@@ -0,0 +1,250 @@
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { ByteArray } from "../../util/ByteArray.js";
+import { MatterError } from "../../common/MatterError.js";
+import { MessageExchange } from "../../protocol/MessageExchange.js";
+import { ExchangeProvider } from "../../protocol/ExchangeManager.js";
+import { MatterController } from "../../MatterController.js";
+import { MatterDevice } from "../../MatterDevice.js";
+import { StatusCode, TlvDataReport, TlvInvokeRequest, TlvInvokeResponse, TlvReadRequest, TlvSubscribeRequest, TlvSubscribeResponse, TlvTimedRequest, TlvWriteRequest, TlvWriteResponse } from "./InteractionProtocol.js";
+import { TypeFromSchema } from "../../tlv/TlvSchema.js";
+import { Message } from "../../codec/MessageCodec.js";
+export declare const enum MessageType {
+    StatusResponse = 1,
+    ReadRequest = 2,
+    SubscribeRequest = 3,
+    SubscribeResponse = 4,
+    ReportData = 5,
+    WriteRequest = 6,
+    WriteResponse = 7,
+    InvokeCommandRequest = 8,
+    InvokeCommandResponse = 9,
+    TimedRequest = 10
+}
+export type ReadRequest = TypeFromSchema<typeof TlvReadRequest>;
+export type DataReport = TypeFromSchema<typeof TlvDataReport>;
+export type SubscribeRequest = TypeFromSchema<typeof TlvSubscribeRequest>;
+export type SubscribeResponse = TypeFromSchema<typeof TlvSubscribeResponse>;
+export type InvokeRequest = TypeFromSchema<typeof TlvInvokeRequest>;
+export type InvokeResponse = TypeFromSchema<typeof TlvInvokeResponse>;
+export type TimedRequest = TypeFromSchema<typeof TlvTimedRequest>;
+export type WriteRequest = TypeFromSchema<typeof TlvWriteRequest>;
+export type WriteResponse = TypeFromSchema<typeof TlvWriteResponse>;
+/** Error base Class for all errors related to the status response messages. */
+export declare class StatusResponseError extends MatterError {
+    readonly code: StatusCode;
+    constructor(message: string, code: StatusCode);
+}
+declare class InteractionMessenger<ContextT> {
+    protected exchange: MessageExchange<ContextT>;
+    constructor(exchange: MessageExchange<ContextT>);
+    send(messageType: number, payload: ByteArray): Promise<void>;
+    sendStatus(status: StatusCode): Promise<void>;
+    waitForSuccess(): Promise<void>;
+    nextMessage(expectedMessageType?: number): Promise<Message>;
+    close(): void;
+    protected throwIfErrorStatusMessage(message: Message): void;
+}
+export declare class InteractionServerMessenger extends InteractionMessenger<MatterDevice> {
+    handleRequest(handleReadRequest: (request: ReadRequest) => DataReport, handleWriteRequest: (request: WriteRequest) => WriteResponse, handleSubscribeRequest: (request: SubscribeRequest, messenger: InteractionServerMessenger) => Promise<void>, handleInvokeRequest: (request: InvokeRequest, message: Message) => Promise<InvokeResponse>, handleTimedRequest: (request: TimedRequest) => void): Promise<void>;
+    sendDataReport(dataReport: DataReport): Promise<void>;
+}
+export declare class IncomingInteractionClientMessenger extends InteractionMessenger<MatterController> {
+    readDataReport(): Promise<DataReport>;
+}
+export declare class InteractionClientMessenger extends IncomingInteractionClientMessenger {
+    private readonly exchangeProvider;
+    constructor(exchangeProvider: ExchangeProvider);
+    /** Implements a send method with an automatic reconnection mechanism */
+    send(messageType: number, payload: ByteArray, expectAckOnly?: boolean): Promise<void>;
+    sendReadRequest(readRequest: ReadRequest): Promise<{
+        interactionModelRevision: number;
+        subscriptionId?: number | undefined;
+        attributeReports?: {
+            attributeStatus?: {
+                path: {
+                    nodeId?: import("../../datatype/NodeId.js").NodeId | undefined;
+                    enableTagCompression?: boolean | undefined;
+                    endpointId?: number | undefined;
+                    clusterId?: number | undefined;
+                    attributeId?: number | undefined;
+                    listIndex?: number | null | undefined;
+                };
+                status: {
+                    status?: StatusCode | undefined;
+                    clusterStatus?: StatusCode | undefined;
+                };
+            } | undefined;
+            attributeData?: {
+                data: import("../../tlv/TlvSchema.js").TlvStream;
+                path: {
+                    nodeId?: import("../../datatype/NodeId.js").NodeId | undefined;
+                    enableTagCompression?: boolean | undefined;
+                    endpointId?: number | undefined;
+                    clusterId?: number | undefined;
+                    attributeId?: number | undefined;
+                    listIndex?: number | null | undefined;
+                };
+                dataVersion: number;
+            } | undefined;
+        }[] | undefined;
+        eventReports?: {
+            eventStatus: {
+                path: {
+                    node?: import("../../datatype/NodeId.js").NodeId | undefined;
+                    endpoint?: number | undefined;
+                    cluster?: number | undefined;
+                    event?: number | undefined;
+                    isUrgent?: boolean | undefined;
+                };
+                status: {
+                    status?: StatusCode | undefined;
+                    clusterStatus?: StatusCode | undefined;
+                };
+            };
+            eventData: {
+                path: {
+                    node?: import("../../datatype/NodeId.js").NodeId | undefined;
+                    endpoint?: number | undefined;
+                    cluster?: number | undefined;
+                    event?: number | undefined;
+                    isUrgent?: boolean | undefined;
+                };
+                eventNumber: number | bigint;
+                priority: number;
+                data?: import("../../tlv/TlvSchema.js").TlvStream | undefined;
+                epochTimestamp?: number | bigint | undefined;
+                systemTimestamp?: number | bigint | undefined;
+                deltaEpochTimestamp?: number | bigint | undefined;
+                deltaSystemTimestamp?: number | bigint | undefined;
+            };
+        }[] | undefined;
+        moreChunkedMessages?: boolean | undefined;
+        suppressResponse?: boolean | undefined;
+    }>;
+    sendSubscribeRequest(subscribeRequest: SubscribeRequest): Promise<{
+        subscribeResponse: {
+            interactionModelRevision: number;
+            subscriptionId: number;
+            maxInterval: number;
+        };
+        report: {
+            interactionModelRevision: number;
+            subscriptionId?: number | undefined;
+            attributeReports?: {
+                attributeStatus?: {
+                    path: {
+                        nodeId?: import("../../datatype/NodeId.js").NodeId | undefined;
+                        enableTagCompression?: boolean | undefined;
+                        endpointId?: number | undefined;
+                        clusterId?: number | undefined;
+                        attributeId?: number | undefined;
+                        listIndex?: number | null | undefined;
+                    };
+                    status: {
+                        status?: StatusCode | undefined;
+                        clusterStatus?: StatusCode | undefined;
+                    };
+                } | undefined;
+                attributeData?: {
+                    data: import("../../tlv/TlvSchema.js").TlvStream;
+                    path: {
+                        nodeId?: import("../../datatype/NodeId.js").NodeId | undefined;
+                        enableTagCompression?: boolean | undefined;
+                        endpointId?: number | undefined;
+                        clusterId?: number | undefined;
+                        attributeId?: number | undefined;
+                        listIndex?: number | null | undefined;
+                    };
+                    dataVersion: number;
+                } | undefined;
+            }[] | undefined;
+            eventReports?: {
+                eventStatus: {
+                    path: {
+                        node?: import("../../datatype/NodeId.js").NodeId | undefined;
+                        endpoint?: number | undefined;
+                        cluster?: number | undefined;
+                        event?: number | undefined;
+                        isUrgent?: boolean | undefined;
+                    };
+                    status: {
+                        status?: StatusCode | undefined;
+                        clusterStatus?: StatusCode | undefined;
+                    };
+                };
+                eventData: {
+                    path: {
+                        node?: import("../../datatype/NodeId.js").NodeId | undefined;
+                        endpoint?: number | undefined;
+                        cluster?: number | undefined;
+                        event?: number | undefined;
+                        isUrgent?: boolean | undefined;
+                    };
+                    eventNumber: number | bigint;
+                    priority: number;
+                    data?: import("../../tlv/TlvSchema.js").TlvStream | undefined;
+                    epochTimestamp?: number | bigint | undefined;
+                    systemTimestamp?: number | bigint | undefined;
+                    deltaEpochTimestamp?: number | bigint | undefined;
+                    deltaSystemTimestamp?: number | bigint | undefined;
+                };
+            }[] | undefined;
+            moreChunkedMessages?: boolean | undefined;
+            suppressResponse?: boolean | undefined;
+        };
+    }>;
+    sendInvokeCommand(invokeRequest: InvokeRequest): Promise<{
+        interactionModelRevision: number;
+        suppressResponse: boolean;
+        invokeResponses: {
+            status?: {
+                status: {
+                    status?: StatusCode | undefined;
+                    clusterStatus?: StatusCode | undefined;
+                };
+                commandPath: {
+                    clusterId: number;
+                    commandId: number;
+                    endpointId?: number | undefined;
+                };
+            } | undefined;
+            command?: {
+                commandPath: {
+                    clusterId: number;
+                    commandId: number;
+                    endpointId?: number | undefined;
+                };
+                commandFields?: import("../../tlv/TlvSchema.js").TlvStream | undefined;
+            } | undefined;
+        }[];
+    } | undefined>;
+    sendWriteCommand(writeRequest: WriteRequest): Promise<{
+        interactionModelRevision: number;
+        writeResponses: {
+            path: {
+                nodeId?: import("../../datatype/NodeId.js").NodeId | undefined;
+                enableTagCompression?: boolean | undefined;
+                endpointId?: number | undefined;
+                clusterId?: number | undefined;
+                attributeId?: number | undefined;
+                listIndex?: number | null | undefined;
+            };
+            status: {
+                status?: StatusCode | undefined;
+                clusterStatus?: StatusCode | undefined;
+            };
+        }[];
+    } | undefined>;
+    sendTimedRequest(timeoutSeconds: number): Promise<{
+        status: StatusCode;
+        interactionModelRevision: number;
+    }>;
+    private requestWithSuppressedResponse;
+    private request;
+}
+export {};
+//# sourceMappingURL=InteractionMessenger.d.ts.map

package/dist/es/protocol/interaction/InteractionMessenger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InteractionMessenger.d.ts","sourceRoot":"","sources":["../../../../src/protocol/interaction/InteractionMessenger.ts"],"names":[],"mappings":"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"}