@project-chip/matter.js 0.2.0 → 0.3.0

package/dist/cjs/protocol/interaction/InteractionProtocol.js

@@ -0,0 +1,189 @@
+"use strict";
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TlvWriteResponse = exports.TlvWriteRequest = exports.TlvTimedRequest = exports.TlvInvokeResponse = exports.TlvInvokeRequest = exports.TlvSubscribeResponse = exports.TlvSubscribeRequest = exports.TlvDataReport = exports.TlvReadRequest = exports.TlvStatusResponse = exports.TlvInvokeResponseData = exports.TlvCommandStatus = exports.TlvCommandData = exports.TlvCommandPath = exports.TlvEventReport = exports.TlvEventStatus = exports.TlvAttributeReport = exports.TlvAttributeReportData = exports.TlvAttributeData = exports.TlvAttributeStatus = exports.TlvStatus = exports.TlvDataVersionFilter = exports.TlvClusterPath = exports.TlvEventFilter = exports.TlvEventData = exports.TlvEventPath = exports.TlvAttributePath = void 0;
+const NodeId_js_1 = require("../../datatype/NodeId.js");
+const TlvAny_js_1 = require("../../tlv/TlvAny.js");
+const TlvArray_js_1 = require("../../tlv/TlvArray.js");
+const TlvBoolean_js_1 = require("../../tlv/TlvBoolean.js");
+const TlvNullable_js_1 = require("../../tlv/TlvNullable.js");
+const TlvNumber_js_1 = require("../../tlv/TlvNumber.js");
+const TlvObject_js_1 = require("../../tlv/TlvObject.js");
+// Data structures
+/** @see {@link MatterCoreSpecificationV1_0}, section 10.5.2 */
+exports.TlvAttributePath = (0, TlvObject_js_1.TlvList)({
+    enableTagCompression: (0, TlvObject_js_1.TlvOptionalField)(0, TlvBoolean_js_1.TlvBoolean),
+    nodeId: (0, TlvObject_js_1.TlvOptionalField)(1, NodeId_js_1.TlvNodeId),
+    endpointId: (0, TlvObject_js_1.TlvOptionalField)(2, TlvNumber_js_1.TlvUInt16),
+    clusterId: (0, TlvObject_js_1.TlvOptionalField)(3, TlvNumber_js_1.TlvUInt32),
+    attributeId: (0, TlvObject_js_1.TlvOptionalField)(4, TlvNumber_js_1.TlvUInt32),
+    listIndex: (0, TlvObject_js_1.TlvOptionalField)(5, (0, TlvNullable_js_1.TlvNullable)(TlvNumber_js_1.TlvUInt16)),
+});
+/** @see {@link MatterCoreSpecificationV1_0}, section 10.5.8 */
+exports.TlvEventPath = (0, TlvObject_js_1.TlvList)({
+    node: (0, TlvObject_js_1.TlvOptionalField)(0, NodeId_js_1.TlvNodeId),
+    endpoint: (0, TlvObject_js_1.TlvOptionalField)(1, TlvNumber_js_1.TlvUInt16),
+    cluster: (0, TlvObject_js_1.TlvOptionalField)(2, TlvNumber_js_1.TlvUInt32),
+    event: (0, TlvObject_js_1.TlvOptionalField)(3, TlvNumber_js_1.TlvUInt32),
+    isUrgent: (0, TlvObject_js_1.TlvOptionalField)(4, TlvBoolean_js_1.TlvBoolean),
+});
+/** @see {@link MatterCoreSpecificationV1_0}, section 10.5.9 */
+exports.TlvEventData = (0, TlvObject_js_1.TlvObject)({
+    path: (0, TlvObject_js_1.TlvField)(0, exports.TlvEventPath),
+    eventNumber: (0, TlvObject_js_1.TlvField)(1, TlvNumber_js_1.TlvUInt64),
+    priority: (0, TlvObject_js_1.TlvField)(2, TlvNumber_js_1.TlvUInt8),
+    epochTimestamp: (0, TlvObject_js_1.TlvOptionalField)(3, TlvNumber_js_1.TlvInt64),
+    systemTimestamp: (0, TlvObject_js_1.TlvOptionalField)(4, TlvNumber_js_1.TlvUInt64),
+    deltaEpochTimestamp: (0, TlvObject_js_1.TlvOptionalField)(5, TlvNumber_js_1.TlvUInt64),
+    deltaSystemTimestamp: (0, TlvObject_js_1.TlvOptionalField)(6, TlvNumber_js_1.TlvUInt64),
+    data: (0, TlvObject_js_1.TlvOptionalField)(7, TlvAny_js_1.TlvAny),
+});
+/** @see {@link MatterCoreSpecificationV1_0}, section 10.5.6 */
+exports.TlvEventFilter = (0, TlvObject_js_1.TlvList)({
+    node: (0, TlvObject_js_1.TlvOptionalField)(0, NodeId_js_1.TlvNodeId),
+    eventMin: (0, TlvObject_js_1.TlvField)(1, TlvNumber_js_1.TlvUInt64),
+});
+/** @see {@link MatterCoreSpecificationV1_0}, section 10.5.7 */
+exports.TlvClusterPath = (0, TlvObject_js_1.TlvList)({
+    node: (0, TlvObject_js_1.TlvOptionalField)(0, NodeId_js_1.TlvNodeId),
+    endpoint: (0, TlvObject_js_1.TlvField)(1, TlvNumber_js_1.TlvUInt16),
+    cluster: (0, TlvObject_js_1.TlvField)(2, TlvNumber_js_1.TlvUInt32),
+});
+/** @see {@link MatterCoreSpecificationV1_0}, section 10.5.3 */
+exports.TlvDataVersionFilter = (0, TlvObject_js_1.TlvObject)({
+    path: (0, TlvObject_js_1.TlvField)(0, exports.TlvClusterPath),
+    dataVersion: (0, TlvObject_js_1.TlvField)(1, TlvNumber_js_1.TlvUInt32),
+});
+/** @see {@link MatterCoreSpecificationV1_0}, section 10.5.17 */
+exports.TlvStatus = (0, TlvObject_js_1.TlvObject)({
+    status: (0, TlvObject_js_1.TlvOptionalField)(0, (0, TlvNumber_js_1.TlvEnum)()),
+    clusterStatus: (0, TlvObject_js_1.TlvOptionalField)(1, (0, TlvNumber_js_1.TlvEnum)()),
+});
+/** @see {@link MatterCoreSpecificationV1_0}, section 10.5.16 */
+exports.TlvAttributeStatus = (0, TlvObject_js_1.TlvObject)({
+    path: (0, TlvObject_js_1.TlvField)(0, exports.TlvAttributePath),
+    status: (0, TlvObject_js_1.TlvField)(1, exports.TlvStatus),
+});
+/** @see {@link MatterCoreSpecificationV1_0}, section 10.5.4 */
+exports.TlvAttributeData = (0, TlvObject_js_1.TlvObject)({
+    dataVersion: (0, TlvObject_js_1.TlvOptionalField)(0, TlvNumber_js_1.TlvUInt32),
+    path: (0, TlvObject_js_1.TlvField)(1, exports.TlvAttributePath),
+    data: (0, TlvObject_js_1.TlvField)(2, TlvAny_js_1.TlvAny),
+});
+exports.TlvAttributeReportData = (0, TlvObject_js_1.TlvObject)({
+    dataVersion: (0, TlvObject_js_1.TlvField)(0, TlvNumber_js_1.TlvUInt32),
+    path: (0, TlvObject_js_1.TlvField)(1, exports.TlvAttributePath),
+    data: (0, TlvObject_js_1.TlvField)(2, TlvAny_js_1.TlvAny),
+});
+/** @see {@link MatterCoreSpecificationV1_0}, section 10.5.5 */
+exports.TlvAttributeReport = (0, TlvObject_js_1.TlvObject)({
+    attributeStatus: (0, TlvObject_js_1.TlvOptionalField)(0, exports.TlvAttributeStatus),
+    attributeData: (0, TlvObject_js_1.TlvOptionalField)(1, exports.TlvAttributeReportData),
+});
+/** @see {@link MatterCoreSpecificationV1_0}, section 10.5.15 */
+exports.TlvEventStatus = (0, TlvObject_js_1.TlvObject)({
+    path: (0, TlvObject_js_1.TlvField)(0, exports.TlvEventPath),
+    status: (0, TlvObject_js_1.TlvField)(1, exports.TlvStatus),
+});
+/** @see {@link MatterCoreSpecificationV1_0}, section 10.5.10 */
+exports.TlvEventReport = (0, TlvObject_js_1.TlvObject)({
+    eventStatus: (0, TlvObject_js_1.TlvField)(0, exports.TlvEventStatus),
+    eventData: (0, TlvObject_js_1.TlvField)(1, exports.TlvEventData),
+});
+/** @see {@link MatterCoreSpecificationV1_0}, section 10.5.11 */
+exports.TlvCommandPath = (0, TlvObject_js_1.TlvList)({
+    endpointId: (0, TlvObject_js_1.TlvOptionalField)(0, TlvNumber_js_1.TlvUInt16),
+    clusterId: (0, TlvObject_js_1.TlvField)(1, TlvNumber_js_1.TlvUInt32),
+    commandId: (0, TlvObject_js_1.TlvField)(2, TlvNumber_js_1.TlvUInt32),
+});
+/** @see {@link MatterCoreSpecificationV1_0}, section 10.5.12 */
+exports.TlvCommandData = (0, TlvObject_js_1.TlvObject)({
+    commandPath: (0, TlvObject_js_1.TlvField)(0, exports.TlvCommandPath),
+    commandFields: (0, TlvObject_js_1.TlvOptionalField)(1, TlvAny_js_1.TlvAny),
+});
+/** @see {@link MatterCoreSpecificationV1_0}, section 10.5.14 */
+exports.TlvCommandStatus = (0, TlvObject_js_1.TlvObject)({
+    commandPath: (0, TlvObject_js_1.TlvField)(0, exports.TlvCommandPath),
+    status: (0, TlvObject_js_1.TlvField)(1, exports.TlvStatus),
+});
+/** @see {@link MatterCoreSpecificationV1_0}, section 10.5.13 */
+exports.TlvInvokeResponseData = (0, TlvObject_js_1.TlvObject)({
+    command: (0, TlvObject_js_1.TlvOptionalField)(0, exports.TlvCommandData),
+    status: (0, TlvObject_js_1.TlvOptionalField)(1, exports.TlvCommandStatus),
+});
+// Request/Response Messages
+/** @see {@link MatterCoreSpecificationV1_0}, section 10.6.1 */
+exports.TlvStatusResponse = (0, TlvObject_js_1.TlvObject)({
+    status: (0, TlvObject_js_1.TlvField)(0, (0, TlvNumber_js_1.TlvEnum)()),
+    interactionModelRevision: (0, TlvObject_js_1.TlvField)(0xFF, TlvNumber_js_1.TlvUInt8),
+});
+/** @see {@link MatterCoreSpecificationV1_0}, section 10.6.2 */
+exports.TlvReadRequest = (0, TlvObject_js_1.TlvObject)({
+    attributeRequests: (0, TlvObject_js_1.TlvOptionalField)(0, (0, TlvArray_js_1.TlvArray)(exports.TlvAttributePath)),
+    eventRequests: (0, TlvObject_js_1.TlvOptionalField)(1, (0, TlvArray_js_1.TlvArray)(exports.TlvEventPath)),
+    eventFilters: (0, TlvObject_js_1.TlvOptionalField)(2, (0, TlvArray_js_1.TlvArray)(exports.TlvEventFilter)),
+    isFabricFiltered: (0, TlvObject_js_1.TlvField)(3, TlvBoolean_js_1.TlvBoolean),
+    dataVersionFilters: (0, TlvObject_js_1.TlvOptionalField)(4, (0, TlvArray_js_1.TlvArray)(exports.TlvDataVersionFilter)),
+    interactionModelRevision: (0, TlvObject_js_1.TlvField)(0xFF, TlvNumber_js_1.TlvUInt8),
+});
+/** @see {@link MatterCoreSpecificationV1_0}, section 10.6.3 */
+exports.TlvDataReport = (0, TlvObject_js_1.TlvObject)({
+    subscriptionId: (0, TlvObject_js_1.TlvOptionalField)(0, TlvNumber_js_1.TlvUInt32),
+    attributeReports: (0, TlvObject_js_1.TlvOptionalField)(1, (0, TlvArray_js_1.TlvArray)(exports.TlvAttributeReport)),
+    eventReports: (0, TlvObject_js_1.TlvOptionalField)(2, (0, TlvArray_js_1.TlvArray)(exports.TlvEventReport)),
+    moreChunkedMessages: (0, TlvObject_js_1.TlvOptionalField)(3, TlvBoolean_js_1.TlvBoolean),
+    suppressResponse: (0, TlvObject_js_1.TlvOptionalField)(4, TlvBoolean_js_1.TlvBoolean),
+    interactionModelRevision: (0, TlvObject_js_1.TlvField)(0xFF, TlvNumber_js_1.TlvUInt8),
+});
+/** @see {@link MatterCoreSpecificationV1_0}, section 10.6.4 */
+exports.TlvSubscribeRequest = (0, TlvObject_js_1.TlvObject)({
+    keepSubscriptions: (0, TlvObject_js_1.TlvField)(0, TlvBoolean_js_1.TlvBoolean),
+    minIntervalFloorSeconds: (0, TlvObject_js_1.TlvField)(1, TlvNumber_js_1.TlvUInt16),
+    maxIntervalCeilingSeconds: (0, TlvObject_js_1.TlvField)(2, TlvNumber_js_1.TlvUInt16),
+    attributeRequests: (0, TlvObject_js_1.TlvOptionalField)(3, (0, TlvArray_js_1.TlvArray)(exports.TlvAttributePath)),
+    eventRequests: (0, TlvObject_js_1.TlvOptionalField)(4, (0, TlvArray_js_1.TlvArray)(exports.TlvEventPath)),
+    eventFilters: (0, TlvObject_js_1.TlvOptionalField)(5, (0, TlvArray_js_1.TlvArray)(exports.TlvEventFilter)),
+    isFabricFiltered: (0, TlvObject_js_1.TlvField)(7, TlvBoolean_js_1.TlvBoolean),
+    dataVersionFilters: (0, TlvObject_js_1.TlvOptionalField)(8, (0, TlvArray_js_1.TlvArray)(exports.TlvDataVersionFilter)),
+});
+/** @see {@link MatterCoreSpecificationV1_0}, section 10.6.5 */
+exports.TlvSubscribeResponse = (0, TlvObject_js_1.TlvObject)({
+    subscriptionId: (0, TlvObject_js_1.TlvField)(0, TlvNumber_js_1.TlvUInt32),
+    maxInterval: (0, TlvObject_js_1.TlvField)(2, TlvNumber_js_1.TlvUInt16),
+    interactionModelRevision: (0, TlvObject_js_1.TlvField)(0xFF, TlvNumber_js_1.TlvUInt8),
+});
+/** @see {@link MatterCoreSpecificationV1_0}, section 10.6.9 */
+exports.TlvInvokeRequest = (0, TlvObject_js_1.TlvObject)({
+    suppressResponse: (0, TlvObject_js_1.TlvField)(0, TlvBoolean_js_1.TlvBoolean),
+    timedRequest: (0, TlvObject_js_1.TlvField)(1, TlvBoolean_js_1.TlvBoolean),
+    invokeRequests: (0, TlvObject_js_1.TlvField)(2, (0, TlvArray_js_1.TlvArray)(exports.TlvCommandData)),
+    interactionModelRevision: (0, TlvObject_js_1.TlvField)(0xFF, TlvNumber_js_1.TlvUInt8),
+});
+/** @see {@link MatterCoreSpecificationV1_0}, section 10.6.10 */
+exports.TlvInvokeResponse = (0, TlvObject_js_1.TlvObject)({
+    suppressResponse: (0, TlvObject_js_1.TlvField)(0, TlvBoolean_js_1.TlvBoolean),
+    invokeResponses: (0, TlvObject_js_1.TlvField)(1, (0, TlvArray_js_1.TlvArray)(exports.TlvInvokeResponseData)),
+    interactionModelRevision: (0, TlvObject_js_1.TlvField)(0xFF, TlvNumber_js_1.TlvUInt8),
+});
+/** @see {@link MatterCoreSpecificationV1_0}, section 10.6.8 */
+exports.TlvTimedRequest = (0, TlvObject_js_1.TlvObject)({
+    timeout: (0, TlvObject_js_1.TlvField)(0, TlvNumber_js_1.TlvUInt16),
+    interactionModelRevision: (0, TlvObject_js_1.TlvField)(0xFF, TlvNumber_js_1.TlvUInt8), //??
+});
+/** @see {@link MatterCoreSpecificationV1_0}, section 10.6.6 */
+exports.TlvWriteRequest = (0, TlvObject_js_1.TlvObject)({
+    suppressResponse: (0, TlvObject_js_1.TlvOptionalField)(0, TlvBoolean_js_1.TlvBoolean),
+    timedRequest: (0, TlvObject_js_1.TlvField)(1, TlvBoolean_js_1.TlvBoolean),
+    writeRequests: (0, TlvObject_js_1.TlvField)(2, (0, TlvArray_js_1.TlvArray)(exports.TlvAttributeData)),
+    moreChunkedMessages: (0, TlvObject_js_1.TlvOptionalField)(3, TlvBoolean_js_1.TlvBoolean),
+    interactionModelRevision: (0, TlvObject_js_1.TlvField)(0xFF, TlvNumber_js_1.TlvUInt8),
+});
+/** @see {@link MatterCoreSpecificationV1_0}, section 10.6.7 */
+exports.TlvWriteResponse = (0, TlvObject_js_1.TlvObject)({
+    writeResponses: (0, TlvObject_js_1.TlvField)(0, (0, TlvArray_js_1.TlvArray)(exports.TlvAttributeStatus)),
+    interactionModelRevision: (0, TlvObject_js_1.TlvField)(0xFF, TlvNumber_js_1.TlvUInt8),
+});

package/dist/cjs/protocol/interaction/InteractionServer.d.ts

@@ -0,0 +1,71 @@
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { MatterDevice } from "../../MatterDevice.js";
+import { ProtocolHandler } from "../../protocol/ProtocolHandler.js";
+import { MessageExchange } from "../../protocol/MessageExchange.js";
+import { DataReport, InteractionServerMessenger, InvokeRequest, InvokeResponse, ReadRequest, SubscribeRequest, TimedRequest, WriteRequest, WriteResponse } from "./InteractionMessenger.js";
+import { Attributes, Cluster, Commands, Events } from "../../cluster/Cluster.js";
+import { TlvAttributePath } from "./InteractionProtocol.js";
+import { BitSchema, TypeFromBitSchema } from "../../schema/BitmapSchema.js";
+import { TypeFromSchema } from "../../tlv/TlvSchema.js";
+import { Message } from "../../codec/MessageCodec.js";
+import { AttributeInitialValues, AttributeServers, ClusterServerHandlers } from "../../cluster/server/ClusterServer.js";
+import { CommandServer } from "../../cluster/server/CommandServer.js";
+import { AttributeServer } from "../../cluster/server/AttributeServer.js";
+import { StorageContext } from "../../storage/StorageContext.js";
+import { StorageManager } from "../../storage/StorageManager.js";
+export declare const INTERACTION_PROTOCOL_ID = 1;
+export declare class ClusterServer<F extends BitSchema, A extends Attributes, C extends Commands, E extends Events> {
+    readonly id: number;
+    readonly name: string;
+    readonly attributes: AttributeServers<A>;
+    readonly commands: CommandServer<any, any>[];
+    private clusterStorage;
+    private attributeStorageListeners;
+    constructor(clusterDef: Cluster<F, A, C, E>, features: TypeFromBitSchema<F>, attributesInitialValues: AttributeInitialValues<A>, handlers: ClusterServerHandlers<Cluster<F, A, C, E>>);
+    setStorage(storageContext: StorageContext): void;
+    attributeStorageListener(attributeName: string, version: number, value: any): void;
+}
+export interface CommandPath {
+    endpointId: number;
+    clusterId: number;
+    commandId: number;
+}
+export interface AttributePath {
+    endpointId: number;
+    clusterId: number;
+    attributeId: number;
+}
+export interface AttributeWithPath {
+    path: TypeFromSchema<typeof TlvAttributePath>;
+    attribute: AttributeServer<any>;
+}
+export declare function commandPathToId({ endpointId, clusterId, commandId }: CommandPath): string;
+export declare function attributePathToId({ endpointId, clusterId, attributeId }: TypeFromSchema<typeof TlvAttributePath>): string;
+export declare class InteractionServer implements ProtocolHandler<MatterDevice> {
+    private readonly storageManager;
+    private readonly endpoints;
+    private readonly attributes;
+    private readonly attributePaths;
+    private readonly commands;
+    private readonly commandPaths;
+    private nextSubscriptionId;
+    constructor(storageManager: StorageManager);
+    getId(): number;
+    addEndpoint(endpointId: number, device: {
+        name: string;
+        code: number;
+    }, clusters: ClusterServer<any, any, any, any>[]): this;
+    onNewExchange(exchange: MessageExchange<MatterDevice>): Promise<void>;
+    handleReadRequest(exchange: MessageExchange<MatterDevice>, { attributeRequests: attributePaths, isFabricFiltered }: ReadRequest): DataReport;
+    handleWriteRequest(exchange: MessageExchange<MatterDevice>, { suppressResponse, writeRequests }: WriteRequest): WriteResponse;
+    handleSubscribeRequest(exchange: MessageExchange<MatterDevice>, { minIntervalFloorSeconds, maxIntervalCeilingSeconds, attributeRequests, eventRequests, keepSubscriptions }: SubscribeRequest, messenger: InteractionServerMessenger): Promise<void>;
+    handleInvokeRequest(exchange: MessageExchange<MatterDevice>, { invokeRequests }: InvokeRequest, message: Message): Promise<InvokeResponse>;
+    handleTimedRequest(exchange: MessageExchange<MatterDevice>, { timeout }: TimedRequest): void;
+    private resolveAttributeName;
+    private getAttributes;
+}
+//# sourceMappingURL=InteractionServer.d.ts.map

package/dist/cjs/protocol/interaction/InteractionServer.d.ts.map

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

package/dist/cjs/protocol/interaction/InteractionServer.js

@@ -0,0 +1,369 @@
+"use strict";
+/**
+ * @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());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InteractionServer = exports.attributePathToId = exports.commandPathToId = exports.ClusterServer = exports.INTERACTION_PROTOCOL_ID = void 0;
+const InteractionMessenger_js_1 = require("./InteractionMessenger.js");
+const InteractionProtocol_js_1 = require("./InteractionProtocol.js");
+const TlvNoArguments_js_1 = require("../../tlv/TlvNoArguments.js");
+const DeviceTypeId_js_1 = require("../../datatype/DeviceTypeId.js");
+const ClusterId_js_1 = require("../../datatype/ClusterId.js");
+const EndpointNumber_js_1 = require("../../datatype/EndpointNumber.js");
+const SubscriptionHandler_js_1 = require("./SubscriptionHandler.js");
+const Crypto_js_1 = require("../../crypto/Crypto.js");
+const AttributeDataDecoder_js_1 = require("./AttributeDataDecoder.js");
+const CommandServer_js_1 = require("../../cluster/server/CommandServer.js");
+const AttributeServer_js_1 = require("../../cluster/server/AttributeServer.js");
+const DescriptorCluster_js_1 = require("../../cluster/DescriptorCluster.js");
+const Logger_js_1 = require("../../log/Logger.js");
+const String_js_1 = require("../../util/String.js");
+const TlvVoid_js_1 = require("../../tlv/TlvVoid.js");
+exports.INTERACTION_PROTOCOL_ID = 0x0001;
+const logger = Logger_js_1.Logger.get("InteractionProtocol");
+class ClusterServer {
+    constructor(clusterDef, features, attributesInitialValues, handlers) {
+        this.attributes = {};
+        this.commands = new Array();
+        this.clusterStorage = null;
+        this.attributeStorageListeners = new Map();
+        const { id, name, attributes: attributeDefs, commands: commandDefs } = clusterDef;
+        this.id = id;
+        this.name = name;
+        // Create attributes
+        attributesInitialValues = Object.assign(Object.assign({}, attributesInitialValues), { clusterRevision: clusterDef.revision, featureMap: features });
+        for (const name in attributesInitialValues) {
+            const { id, schema, writable, persistent } = attributeDefs[name];
+            const validator = typeof schema.validate === 'function' ? schema.validate.bind(schema) : undefined;
+            const getter = handlers[`get${(0, String_js_1.capitalize)(name)}`];
+            if (getter === undefined) {
+                this.attributes[name] = new AttributeServer_js_1.AttributeServer(id, name, schema, validator !== null && validator !== void 0 ? validator : (() => { }), writable, attributesInitialValues[name]);
+            }
+            else {
+                this.attributes[name] = new AttributeServer_js_1.AttributeGetterServer(id, name, schema, validator !== null && validator !== void 0 ? validator : (() => { }), writable, attributesInitialValues[name], getter);
+            }
+            if (persistent) {
+                const listener = (value, version) => this.attributeStorageListener(name, version, value);
+                this.attributeStorageListeners.set(id, listener);
+                this.attributes[name].addMatterListener(listener);
+            }
+        }
+        // Create commands
+        for (const name in commandDefs) {
+            const handler = handlers[name];
+            if (handler === undefined)
+                continue;
+            const { requestId, requestSchema, responseId, responseSchema } = commandDefs[name];
+            this.commands.push(new CommandServer_js_1.CommandServer(requestId, responseId, name, requestSchema, responseSchema, (request, session, message) => handler({ request, attributes: this.attributes, session, message })));
+        }
+    }
+    setStorage(storageContext) {
+        this.clusterStorage = storageContext;
+        for (const name in this.attributes) {
+            const attribute = this.attributes[name];
+            if (!this.attributeStorageListeners.has(attribute.id))
+                return;
+            if (!storageContext.has(attribute.name))
+                return;
+            try {
+                const data = storageContext.get(attribute.name);
+                logger.debug(`Restoring attribute ${attribute.name} (${attribute.id}) in cluster ${this.name} (${this.id})`);
+                attribute.init(data.value, data.version);
+            }
+            catch (error) {
+                logger.warn(`Failed to restore attribute ${attribute.name} (${attribute.id}) in cluster ${this.name} (${this.id})`, error);
+            }
+        }
+    }
+    attributeStorageListener(attributeName, version, value) {
+        if (!this.clusterStorage)
+            return;
+        logger.debug(`Storing attribute ${attributeName} in cluster ${this.name} (${this.id})`);
+        this.clusterStorage.set(attributeName, { version, value });
+    }
+}
+exports.ClusterServer = ClusterServer;
+function commandPathToId({ endpointId, clusterId, commandId }) {
+    return `${endpointId}/${clusterId}/${commandId}`;
+}
+exports.commandPathToId = commandPathToId;
+function attributePathToId({ endpointId, clusterId, attributeId }) {
+    return `${endpointId}/${clusterId}/${attributeId}`;
+}
+exports.attributePathToId = attributePathToId;
+function toHex(value) {
+    return value === undefined ? "*" : `0x${value.toString(16)}`;
+}
+class InteractionServer {
+    constructor(storageManager) {
+        this.storageManager = storageManager;
+        this.endpoints = new Map();
+        this.attributes = new Map();
+        this.attributePaths = new Array();
+        this.commands = new Map();
+        this.commandPaths = new Array();
+        this.nextSubscriptionId = Crypto_js_1.Crypto.getRandomUInt32();
+    }
+    getId() {
+        return exports.INTERACTION_PROTOCOL_ID;
+    }
+    addEndpoint(endpointId, device, clusters) {
+        // Add the descriptor cluster
+        const descriptorCluster = new ClusterServer(DescriptorCluster_js_1.DescriptorCluster, {}, {
+            deviceTypeList: [{ revision: 1, deviceType: new DeviceTypeId_js_1.DeviceTypeId(device.code) }],
+            serverList: [],
+            clientList: [],
+            partsList: [],
+        }, {});
+        clusters.push(descriptorCluster);
+        descriptorCluster.attributes.serverList.setLocal(clusters.map(({ id }) => new ClusterId_js_1.ClusterId(id)));
+        const clusterEndpointNumber = new EndpointNumber_js_1.EndpointNumber(endpointId);
+        const clusterMap = new Map();
+        clusters.forEach(cluster => {
+            const { id: clusterId, attributes, commands } = cluster;
+            cluster.setStorage(this.storageManager.createContext(`Cluster-${clusterEndpointNumber.number}-${clusterId}`));
+            clusterMap.set(clusterId, cluster);
+            // Add attributes
+            for (const name in attributes) {
+                const attribute = attributes[name];
+                const path = { endpointId, clusterId, attributeId: attribute.id };
+                this.attributes.set(attributePathToId(path), attribute);
+                this.attributePaths.push(path);
+            }
+            // Add commands
+            commands.forEach(command => {
+                const path = { endpointId, clusterId, commandId: command.invokeId };
+                this.commands.set(commandPathToId(path), command);
+                this.commandPaths.push(path);
+            });
+        });
+        // Add part list if the endpoint is not root
+        if (endpointId !== 0) {
+            const rootPartsListAttribute = this.attributes.get(attributePathToId({ endpointId: 0, clusterId: DescriptorCluster_js_1.DescriptorCluster.id, attributeId: DescriptorCluster_js_1.DescriptorCluster.attributes.partsList.id }));
+            if (rootPartsListAttribute === undefined)
+                throw new Error("The root endpoint should be added first!");
+            rootPartsListAttribute.setLocal([...rootPartsListAttribute.getLocal(), clusterEndpointNumber]);
+        }
+        this.endpoints.set(endpointId, Object.assign(Object.assign({}, device), { clusters: clusterMap }));
+        return this;
+    }
+    onNewExchange(exchange) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield new InteractionMessenger_js_1.InteractionServerMessenger(exchange).handleRequest(readRequest => this.handleReadRequest(exchange, readRequest), writeRequest => this.handleWriteRequest(exchange, writeRequest), (subscribeRequest, messenger) => this.handleSubscribeRequest(exchange, subscribeRequest, messenger), (invokeRequest, message) => this.handleInvokeRequest(exchange, invokeRequest, message), timedRequest => this.handleTimedRequest(exchange, timedRequest));
+        });
+    }
+    handleReadRequest(exchange, { attributeRequests: attributePaths, isFabricFiltered }) {
+        if (attributePaths === undefined) {
+            throw new InteractionMessenger_js_1.StatusResponseError("Only Read requests with attributeRequests are supported right now", 143 /* StatusCode.UnsupportedRead */);
+        }
+        logger.debug(`Received read request from ${exchange.channel.getName()}: ${attributePaths.map(path => this.resolveAttributeName(path)).join(", ")}, isFabricFiltered=${isFabricFiltered}`);
+        // UnsupportedNode/UnsupportedEndpoint/UnsupportedCluster/UnsupportedAttribute/UnsupportedRead
+        const attributeReports = attributePaths.flatMap((path) => {
+            const attributes = this.getAttributes([path]);
+            if (attributes.length === 0) {
+                logger.debug(`Read from ${exchange.channel.getName()}: ${this.resolveAttributeName(path)} unsupported path`);
+                return [{ attributeStatus: { path, status: { status: 134 /* StatusCode.UnsupportedAttribute */ } } }]; // TODO: Find correct status code
+            }
+            return attributes.map(({ path, attribute }) => {
+                const { value, version } = attribute.getWithVersion(exchange.session); // TODO check ACL
+                logger.debug(`Read from ${exchange.channel.getName()}: ${this.resolveAttributeName(path)}=${Logger_js_1.Logger.toJSON(value)} (version=${version})`);
+                return { attributeData: { path, data: attribute.schema.encodeTlv(value), dataVersion: version } };
+            });
+        });
+        return {
+            interactionModelRevision: 1,
+            suppressResponse: false,
+            attributeReports
+        };
+    }
+    handleWriteRequest(exchange, { suppressResponse, writeRequests }) {
+        logger.debug(`Received write request from ${exchange.channel.getName()}: ${writeRequests.map(req => this.resolveAttributeName(req.path)).join(", ")}, suppressResponse=${suppressResponse}`);
+        // TODO consider TimedRequest constraints
+        const writeData = (0, AttributeDataDecoder_js_1.normalizeAttributeData)(writeRequests, true);
+        const writeResults = writeData.flatMap((values) => {
+            const { path, dataVersion } = values[0];
+            const attributes = this.getAttributes([path], true);
+            if (attributes.length === 0) {
+                return [{ path, statusCode: 136 /* StatusCode.UnsupportedWrite */ }]; // TODO: Find correct status code
+            }
+            return attributes.map(({ path, attribute }) => {
+                // TODO add checks or dataVersion
+                // TODO add ACL checks
+                const { schema, defaultValue } = attribute;
+                try {
+                    const value = (0, AttributeDataDecoder_js_1.decodeValueForSchema)(schema, values, defaultValue);
+                    logger.debug(`Handle write request from ${exchange.channel.getName()} resolved to: ${this.resolveAttributeName(path)}=${Logger_js_1.Logger.toJSON(value)} (Version=${dataVersion})`);
+                    attribute.set(value, exchange.session);
+                }
+                catch (error) {
+                    if (attributes.length === 1) { // For Multi-Attribute-Writes we ignore errors
+                        logger.error(`Error while handling write request from ${exchange.channel.getName()} to ${this.resolveAttributeName(path)}: ${error.message}`);
+                        return { path, statusCode: 135 /* StatusCode.ConstraintError */ };
+                    }
+                    else {
+                        logger.debug(`While handling write request from ${exchange.channel.getName()} to ${this.resolveAttributeName(path)} ignored: ${error.message}`);
+                    }
+                }
+                return { path, statusCode: 0 /* StatusCode.Success */ };
+            });
+            //.filter(({ statusCode }) => statusCode !== StatusCode.Success); // see https://github.com/project-chip/connectedhomeip/issues/26198
+        });
+        // TODO respect suppressResponse, potentially also needs adjustment in InteractionMessenger class!
+        const errorResults = writeResults.filter(({ statusCode }) => statusCode !== 0 /* StatusCode.Success */);
+        logger.debug(`Write request from ${exchange.channel.getName()} done ${errorResults.length ? `with following errors: ${errorResults.map(({ path, statusCode }) => `${this.resolveAttributeName(path)}=${Logger_js_1.Logger.toJSON(statusCode)}`).join(", ")}` : "without errors"}`);
+        return {
+            interactionModelRevision: 1,
+            writeResponses: writeResults.map(({ path, statusCode }) => ({ path, status: { status: statusCode } })),
+        };
+    }
+    handleSubscribeRequest(exchange, { minIntervalFloorSeconds, maxIntervalCeilingSeconds, attributeRequests, eventRequests, keepSubscriptions }, messenger) {
+        return __awaiter(this, void 0, void 0, function* () {
+            logger.debug(`Received subscribe request from ${exchange.channel.getName()}`);
+            if (!exchange.session.isSecure())
+                throw new Error("Subscriptions are only implemented on secure sessions");
+            const session = exchange.session;
+            const fabric = session.getFabric();
+            if (fabric === undefined)
+                throw new Error("Subscriptions are only implemented after a fabric has been assigned");
+            if ((!Array.isArray(attributeRequests) || attributeRequests.length === 0) && (!Array.isArray(eventRequests) || eventRequests.length === 0)) {
+                throw new InteractionMessenger_js_1.StatusResponseError("No attributes or events requested", 128 /* StatusCode.InvalidAction */);
+            }
+            if (!keepSubscriptions) {
+                session.clearSubscriptions();
+            }
+            // TODO add eventsRequest and other missing supports
+            if (attributeRequests !== undefined) {
+                logger.debug(`Subscribe to ${attributeRequests.map(path => this.resolveAttributeName(path)).join(", ")}`);
+                if (attributeRequests.length === 0)
+                    throw new Error("Unsupported subscription request with empty attribute list");
+                if (minIntervalFloorSeconds < 0)
+                    throw new Error("minIntervalFloorSeconds should be greater or equal to 0");
+                if (maxIntervalCeilingSeconds < 0)
+                    throw new Error("maxIntervalCeilingSeconds should be greater or equal to 1");
+                if (maxIntervalCeilingSeconds < minIntervalFloorSeconds)
+                    throw new Error("maxIntervalCeilingSeconds should be greater or equal to minIntervalFloorSeconds");
+                const attributes = this.getAttributes(attributeRequests);
+                if (!attributes.length) {
+                    throw new InteractionMessenger_js_1.StatusResponseError("Attributes not found", 134 /* StatusCode.UnsupportedAttribute */);
+                }
+                // TODO: Interpret specs:
+                // The publisher SHALL compute an appropriate value for the MaxInterval field in the action. This SHALL respect the following constraint: MinIntervalFloor ≤ MaxInterval ≤ MAX(SUBSCRIPTION_MAX_INTERVAL_PUBLISHER_LIMIT=60mn, MaxIntervalCeiling)
+                if (this.nextSubscriptionId === 0xFFFFFFFF)
+                    this.nextSubscriptionId = 0;
+                const subscriptionId = this.nextSubscriptionId++;
+                const subscriptionHandler = new SubscriptionHandler_js_1.SubscriptionHandler(subscriptionId, session.getContext(), fabric, session.getPeerNodeId(), attributes, minIntervalFloorSeconds, maxIntervalCeilingSeconds);
+                session.addSubscription(subscriptionHandler);
+                // Send initial data report to prime the subscription with initial data
+                yield subscriptionHandler.sendInitialReport(messenger, session);
+                const maxInterval = subscriptionHandler.getMaxInterval();
+                logger.info(`Created subscription ${subscriptionId} for Session ${session.getId()} with ${attributes.length} attributes. Updates: ${minIntervalFloorSeconds} - ${maxIntervalCeilingSeconds} => ${maxInterval} seconds`);
+                // Then send the subscription response
+                yield messenger.send(4 /* MessageType.SubscribeResponse */, InteractionProtocol_js_1.TlvSubscribeResponse.encode({ subscriptionId, maxInterval, interactionModelRevision: 1 }));
+                subscriptionHandler.activateSendingUpdates();
+            }
+        });
+    }
+    handleInvokeRequest(exchange, { invokeRequests }, message) {
+        return __awaiter(this, void 0, void 0, function* () {
+            logger.debug(`Received invoke request from ${exchange.channel.getName()}: ${invokeRequests.map(({ commandPath: { endpointId, clusterId, commandId } }) => `${toHex(endpointId)}/${toHex(clusterId)}/${toHex(commandId)}`).join(", ")}`);
+            const results = new Array();
+            yield Promise.all(invokeRequests.map(({ commandPath, commandFields }) => __awaiter(this, void 0, void 0, function* () {
+                if (commandPath.endpointId === undefined) {
+                    logger.error("Wildcard command invokes not yet supported!");
+                    results.push({ code: 129 /* StatusCode.UnsupportedCommand */, commandPath, response: TlvVoid_js_1.TlvVoid.encodeTlv(), responseId: 0 });
+                    return;
+                }
+                const command = this.commands.get(commandPathToId(commandPath));
+                if (command === undefined)
+                    return;
+                // If no arguments are provided in the invoke data (because optional field), we use our type as replacement
+                if (commandFields === undefined) {
+                    commandFields = TlvNoArguments_js_1.TlvNoArguments.encodeTlv(commandFields);
+                }
+                const result = yield command.invoke(exchange.session, commandFields, message);
+                results.push(Object.assign(Object.assign({}, result), { commandPath }));
+            })));
+            return {
+                suppressResponse: false,
+                interactionModelRevision: 1,
+                invokeResponses: results.map(({ commandPath, responseId, code, response }) => {
+                    if (response.length === 0) {
+                        return { status: { commandPath, status: { status: code } } };
+                    }
+                    else {
+                        return { command: { commandPath: Object.assign(Object.assign({}, commandPath), { commandId: responseId }), commandFields: response } };
+                    }
+                }),
+            };
+        });
+    }
+    handleTimedRequest(exchange, { timeout }) {
+        logger.debug(`Received timed request (${timeout}) from ${exchange.channel.getName()}`);
+        // TODO: implement this
+    }
+    resolveAttributeName({ endpointId, clusterId, attributeId }) {
+        var _a;
+        if (endpointId === undefined) {
+            return `*/${toHex(clusterId)}/${toHex(attributeId)}`;
+        }
+        const endpoint = this.endpoints.get(endpointId);
+        if (endpoint === undefined) {
+            return `unknown(${toHex(endpointId)})/${toHex(clusterId)}/${toHex(attributeId)}`;
+        }
+        const endpointName = `${endpoint.name}(${toHex(endpointId)})`;
+        if (clusterId === undefined) {
+            return `${endpointName}/*/${toHex(attributeId)}`;
+        }
+        const cluster = endpoint.clusters.get(clusterId);
+        if (cluster === undefined) {
+            return `${endpointName}/unknown(${toHex(clusterId)})/${toHex(attributeId)}`;
+        }
+        const clusterName = `${cluster.name}(${toHex(clusterId)})`;
+        if (attributeId === undefined) {
+            return `${endpointName}/${clusterName}/*`;
+        }
+        const attribute = this.attributes.get(attributePathToId({ endpointId, clusterId, attributeId }));
+        const attributeName = `${(_a = attribute === null || attribute === void 0 ? void 0 : attribute.name) !== null && _a !== void 0 ? _a : "unknown"}(${toHex(attributeId)})`;
+        return `${endpointName}/${clusterName}/${attributeName}`;
+    }
+    getAttributes(filters, onlyWritable = false) {
+        const result = new Array();
+        filters.forEach(({ endpointId, clusterId, attributeId }) => {
+            if (endpointId !== undefined && clusterId !== undefined && attributeId !== undefined) {
+                const path = { endpointId, clusterId, attributeId };
+                const attribute = this.attributes.get(attributePathToId(path));
+                if (attribute === undefined)
+                    return;
+                if (onlyWritable && !attribute.isWritable)
+                    return;
+                result.push({ path, attribute });
+            }
+            else {
+                this.attributePaths.filter(path => (endpointId === undefined || endpointId === path.endpointId)
+                    && (clusterId === undefined || clusterId === path.clusterId)
+                    && (attributeId === undefined || attributeId === path.attributeId))
+                    .forEach(path => {
+                    const attribute = this.attributes.get(attributePathToId(path));
+                    if (attribute === undefined)
+                        return;
+                    if (onlyWritable && !attribute.isWritable)
+                        return;
+                    result.push({ path, attribute });
+                });
+            }
+        });
+        return result;
+    }
+}
+exports.InteractionServer = InteractionServer;