@matter/protocol 0.11.0-alpha.0-20241005-e3e4e4a7a

package/dist/esm/fabric/FabricManager.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/fabric/FabricManager.ts"],
+  "mappings": "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",
+  "names": ["FabricAction"]
+}

package/dist/esm/fabric/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./Fabric.js";
+export * from "./FabricManager.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/fabric/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/fabric/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC"}

package/dist/esm/fabric/index.js

@@ -0,0 +1,8 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./Fabric.js";
+export * from "./FabricManager.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/fabric/index.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/fabric/index.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,cAAc;AACd,cAAc;",
+  "names": []
+}

package/dist/esm/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./ble/index.js";
+export * from "./certificate/index.js";
+export * from "./cluster/index.js";
+export * from "./codec/index.js";
+export * from "./common/index.js";
+export * from "./endpoint/index.js";
+export * from "./fabric/index.js";
+export * from "./interaction/index.js";
+export * from "./MatterDevice.js";
+export * from "./mdns/index.js";
+export * from "./peer/index.js";
+export * from "./protocol/index.js";
+export * from "./securechannel/index.js";
+export * from "./session/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,qBAAqB,CAAC;AACpC,cAAc,0BAA0B,CAAC;AACzC,cAAc,oBAAoB,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,20 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+export * from "./ble/index.js";
+export * from "./certificate/index.js";
+export * from "./cluster/index.js";
+export * from "./codec/index.js";
+export * from "./common/index.js";
+export * from "./endpoint/index.js";
+export * from "./fabric/index.js";
+export * from "./interaction/index.js";
+export * from "./MatterDevice.js";
+export * from "./mdns/index.js";
+export * from "./peer/index.js";
+export * from "./protocol/index.js";
+export * from "./securechannel/index.js";
+export * from "./session/index.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../src/index.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;",
+  "names": []
+}

package/dist/esm/interaction/AccessControlManager.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AccessControl } from "#clusters/access-control";
+import { AccessLevel } from "#model";
+import { ClusterId, FabricIndex, NodeId, StatusResponseError } from "#types";
+import { EndpointInterface } from "../endpoint/EndpointInterface.js";
+import { SecureSession } from "../session/SecureSession.js";
+export type AclEntry = Omit<AccessControl.AccessControlEntry, "privilege"> & {
+    privilege: AccessLevel;
+};
+export type AclList = AclEntry[];
+export type AclExtensionEntry = AccessControl.AccessControlExtension;
+export type AclExtensionList = AclExtensionEntry[];
+declare enum AuthModeNone {
+    None = 0
+}
+export type IncomingSubjectDescriptor = {
+    isCommissioning: boolean;
+    authMode: AccessControl.AccessControlEntryAuthMode | AuthModeNone;
+    subjects: NodeId[];
+    fabricIndex: FabricIndex;
+};
+export declare class AccessDeniedError extends StatusResponseError {
+    constructor(message?: string);
+}
+/**
+ * Implements Access Control Logic as per Matter Specification @see {@link MatterSpecification.v12.Core} § 6.6.5.2.
+ */
+export declare class AccessControlManager {
+    #private;
+    constructor(aclList?: AccessControl.AccessControlEntry[], extensionEntryAccessCheck?: (aclList: AclList, aclEntry: AclEntry, subjectDesc: IncomingSubjectDescriptor, endpoint: EndpointInterface, clusterId: ClusterId) => boolean);
+    /**
+     * Public method used to update the Access Control List on changes.
+     */
+    updateAccessControlList(aclList?: AccessControl.AccessControlEntry[]): void;
+    /**
+     * Check if the given ACL entry is allowed to be used for the given subject descriptor, endpoint, and cluster ID.
+     */
+    allowsPrivilege(session: SecureSession, endpoint: EndpointInterface, clusterId: ClusterId, privilege: AccessLevel): boolean;
+    /**
+     * Determines the granted privileges for the given session, endpoint, and cluster ID and returns them.
+     */
+    getGrantedPrivileges(session: SecureSession, endpoint: EndpointInterface, clusterId: ClusterId): AccessLevel[];
+}
+export {};
+//# sourceMappingURL=AccessControlManager.d.ts.map

package/dist/esm/interaction/AccessControlManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AccessControlManager.d.ts","sourceRoot":"","sources":["../../../src/interaction/AccessControlManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,EAAwB,SAAS,EAAE,WAAW,EAAE,MAAM,EAAc,mBAAmB,EAAE,MAAM,QAAQ,CAAC;AAC/G,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAI5D,MAAM,MAAM,QAAQ,GAAG,IAAI,CAAC,aAAa,CAAC,kBAAkB,EAAE,WAAW,CAAC,GAAG;IACzE,SAAS,EAAE,WAAW,CAAC;CAC1B,CAAC;AACF,MAAM,MAAM,OAAO,GAAG,QAAQ,EAAE,CAAC;AAEjC,MAAM,MAAM,iBAAiB,GAAG,aAAa,CAAC,sBAAsB,CAAC;AACrE,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,EAAE,CAAC;AAUnD,aAAK,YAAY;IACb,IAAI,IAAI;CACX;AAED,MAAM,MAAM,yBAAyB,GAAG;IACpC,eAAe,EAAE,OAAO,CAAC;IACzB,QAAQ,EAAE,aAAa,CAAC,0BAA0B,GAAG,YAAY,CAAC;IAClE,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,WAAW,EAAE,WAAW,CAAC;CAC5B,CAAC;AAEF,qBAAa,iBAAkB,SAAQ,mBAAmB;gBAC1C,OAAO,CAAC,EAAE,MAAM;CAG/B;AAED;;GAEG;AACH,qBAAa,oBAAoB;;gBAWzB,OAAO,GAAE,aAAa,CAAC,kBAAkB,EAAO,EAChD,yBAAyB,CAAC,EAAE,CACxB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,QAAQ,EAClB,WAAW,EAAE,yBAAyB,EACtC,QAAQ,EAAE,iBAAiB,EAC3B,SAAS,EAAE,SAAS,KACnB,OAAO;IAQhB;;OAEG;IACH,uBAAuB,CAAC,OAAO,GAAE,aAAa,CAAC,kBAAkB,EAAO,GAAG,IAAI;IAyD/E;;OAEG;IACH,eAAe,CACX,OAAO,EAAE,aAAa,EACtB,QAAQ,EAAE,iBAAiB,EAC3B,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,WAAW,GACvB,OAAO;IAoBV;;OAEG;IACH,oBAAoB,CAAC,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAE,iBAAiB,EAAE,SAAS,EAAE,SAAS,GAAG,WAAW,EAAE;CA8KjH"}

package/dist/esm/interaction/AccessControlManager.js

@@ -0,0 +1,228 @@
+/**
+ * @license
+ * Copyright 2022-2023 Project CHIP Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AccessControl } from "#clusters/access-control";
+import { Logger, MatterFlowError, toHex } from "#general";
+import { AccessLevel } from "#model";
+import { CaseAuthenticatedTag, FabricIndex, NodeId, StatusCode, StatusResponseError } from "#types";
+const logger = Logger.get("AccessControlManager");
+const ImplicitDefaultPaseAclEntry = {
+  fabricIndex: FabricIndex.NO_FABRIC,
+  // not fabric-specific
+  privilege: AccessLevel.Administer,
+  authMode: AccessControl.AccessControlEntryAuthMode.Pase,
+  subjects: [],
+  targets: []
+  // entire node
+};
+var AuthModeNone = /* @__PURE__ */ ((AuthModeNone2) => {
+  AuthModeNone2[AuthModeNone2["None"] = 0] = "None";
+  return AuthModeNone2;
+})(AuthModeNone || {});
+class AccessDeniedError extends StatusResponseError {
+  constructor(message) {
+    super(message ?? "Unauthorized", StatusCode.UnsupportedAccess);
+  }
+}
+class AccessControlManager {
+  #aclList;
+  #extensionEntryAccessCheck = () => true;
+  constructor(aclList = [], extensionEntryAccessCheck) {
+    this.#aclList = aclList;
+    if (extensionEntryAccessCheck !== void 0) {
+      this.#extensionEntryAccessCheck = extensionEntryAccessCheck;
+    }
+  }
+  /**
+   * Public method used to update the Access Control List on changes.
+   */
+  updateAccessControlList(aclList = []) {
+    this.#aclList = [...aclList];
+  }
+  /**
+   * Get the Access Control List for a given fabric.
+   */
+  #getAccessControlEntriesForFabric(fabric) {
+    return this.#aclList.filter((entry) => entry.fabricIndex === fabric.fabricIndex);
+  }
+  /**
+   * Subjects must match exactly, or both are CAT with matching CAT ID and acceptable CAT version
+   */
+  #subjectMatches(aclSubject, isdSubject) {
+    if (aclSubject === isdSubject) {
+      return true;
+    }
+    if (!NodeId.isCaseAuthenticatedTag(aclSubject) || !NodeId.isCaseAuthenticatedTag(isdSubject)) {
+      return false;
+    }
+    const aclSubjectCat = NodeId.extractAsCaseAuthenticatedTag(aclSubject);
+    const isdSubjectCat = NodeId.extractAsCaseAuthenticatedTag(isdSubject);
+    return CaseAuthenticatedTag.getIdentifyValue(aclSubjectCat) === CaseAuthenticatedTag.getIdentifyValue(isdSubjectCat) && CaseAuthenticatedTag.getVersion(isdSubjectCat) >= CaseAuthenticatedTag.getVersion(aclSubjectCat);
+  }
+  /**
+   * Add the new privilege to the granted privileges set and also add any privileges subsumed by the new privilege.
+   */
+  #addGrantedPrivilege(grantedPrivileges, privilege) {
+    grantedPrivileges.add(privilege);
+    switch (privilege) {
+      case AccessLevel.ProxyView:
+        grantedPrivileges.add(AccessLevel.View);
+        break;
+      case AccessLevel.Operate:
+        grantedPrivileges.add(AccessLevel.View);
+        break;
+      case AccessLevel.Manage:
+        grantedPrivileges.add(AccessLevel.Operate);
+        grantedPrivileges.add(AccessLevel.View);
+        break;
+      case AccessLevel.Administer:
+        grantedPrivileges.add(AccessLevel.Manage);
+        grantedPrivileges.add(AccessLevel.Operate);
+        grantedPrivileges.add(AccessLevel.ProxyView);
+        grantedPrivileges.add(AccessLevel.View);
+        break;
+    }
+  }
+  /**
+   * Check if the given ACL entry is allowed to be used for the given subject descriptor, endpoint, and cluster ID.
+   */
+  allowsPrivilege(session, endpoint, clusterId, privilege) {
+    const grantedPrivileges = this.getGrantedPrivileges(session, endpoint, clusterId);
+    if (grantedPrivileges.includes(privilege)) {
+      return true;
+    }
+    logger.notice(
+      `Failed access control check for ${endpoint.number}/0x${toHex(clusterId)} and fabricIndex ${session.associatedFabric.fabricIndex}, acl=`,
+      this.#getAccessControlEntriesForFabric(session.associatedFabric),
+      "with ISD=",
+      this.#getIsdFromMessage(session),
+      "granted privileges=",
+      grantedPrivileges,
+      "not contains",
+      privilege
+    );
+    return false;
+  }
+  /**
+   * Determines the granted privileges for the given session, endpoint, and cluster ID and returns them.
+   */
+  getGrantedPrivileges(session, endpoint, clusterId) {
+    const endpointId = endpoint.number;
+    const fabric = session.fabric;
+    const subjectDesc = this.#getIsdFromMessage(session);
+    const acl = fabric ? this.#getAccessControlEntriesForFabric(fabric) : [ImplicitDefaultPaseAclEntry];
+    const grantedPrivileges = /* @__PURE__ */ new Set();
+    if (subjectDesc.authMode === AccessControl.AccessControlEntryAuthMode.Pase && subjectDesc.isCommissioning) {
+      this.#addGrantedPrivilege(grantedPrivileges, AccessLevel.Administer);
+    }
+    for (const aclEntry of acl) {
+      if (grantedPrivileges.has(AccessLevel.Administer)) {
+        break;
+      }
+      if (aclEntry.fabricIndex === FabricIndex.NO_FABRIC || aclEntry.fabricIndex !== subjectDesc.fabricIndex) {
+        logger.debug(
+          "Skipping ACL entry with mismatched fabric index",
+          aclEntry.fabricIndex,
+          subjectDesc.fabricIndex
+        );
+        continue;
+      }
+      if (aclEntry.authMode !== subjectDesc.authMode) {
+        logger.debug("Skipping ACL entry with mismatched auth mode", aclEntry.authMode, subjectDesc.authMode);
+        continue;
+      }
+      if (aclEntry.subjects === null || aclEntry.subjects.length === 0) {
+        if (aclEntry.authMode !== AccessControl.AccessControlEntryAuthMode.Case && aclEntry.authMode !== AccessControl.AccessControlEntryAuthMode.Group) {
+          throw new MatterFlowError("ACL error: only CASE and Group auth can have empty subjects");
+        }
+      } else {
+        let matchedSubject = false;
+        subjectLoop: for (const aclSubject of aclEntry.subjects) {
+          for (const isdSubject of subjectDesc.subjects) {
+            if (this.#subjectMatches(aclSubject, isdSubject)) {
+              matchedSubject = true;
+              break subjectLoop;
+            }
+          }
+        }
+        if (!matchedSubject) {
+          continue;
+        }
+      }
+      if (aclEntry.targets === null || aclEntry.targets.length === 0) {
+      } else {
+        let matchedTarget = false;
+        for (const {
+          cluster: targetClusterId,
+          endpoint: targetEndpointId,
+          deviceType: targetDeviceType
+        } of aclEntry.targets) {
+          if (targetClusterId === null && targetEndpointId === null && targetDeviceType === null) {
+            throw new MatterFlowError("ACL error: target cannot be empty");
+          }
+          if (targetEndpointId !== null && targetDeviceType !== null) {
+            throw new MatterFlowError("ACL error: target cannot specify both endpoint and device type");
+          }
+          if (targetClusterId !== null && targetClusterId !== clusterId) {
+            continue;
+          }
+          if (targetEndpointId !== null && targetEndpointId !== endpointId) {
+            continue;
+          }
+          if (targetDeviceType !== null && endpoint.deviceType !== targetDeviceType) {
+            continue;
+          }
+          matchedTarget = true;
+          break;
+        }
+        if (!matchedTarget) {
+          continue;
+        }
+      }
+      if (!this.#extensionEntryAccessCheck(acl, aclEntry, subjectDesc, endpoint, clusterId)) {
+        continue;
+      }
+      this.#addGrantedPrivilege(grantedPrivileges, aclEntry.privilege);
+    }
+    if (subjectDesc.authMode === AccessControl.AccessControlEntryAuthMode.Group && grantedPrivileges.has(AccessLevel.Administer)) {
+      throw new MatterFlowError("ACL error: should never grant Administer privilege to a Group");
+    }
+    return [...grantedPrivileges];
+  }
+  /**
+   * Determines the Incoming Subject Descriptor (ISD) from the given session.
+   */
+  #getIsdFromMessage(session) {
+    const fabric = session.fabric;
+    const isd = {
+      isCommissioning: false,
+      authMode: 0 /* None */,
+      subjects: new Array(),
+      fabricIndex: FabricIndex.NO_FABRIC
+    };
+    if (session.isPase) {
+      isd.authMode = AccessControl.AccessControlEntryAuthMode.Pase;
+      isd.isCommissioning = true;
+      isd.subjects.push(NodeId(0));
+      if (fabric) {
+        isd.fabricIndex = fabric.fabricIndex;
+      }
+    } else {
+      isd.authMode = AccessControl.AccessControlEntryAuthMode.Case;
+      isd.subjects.push(session.peerNodeId);
+      session.caseAuthenticatedTags.forEach((cat) => isd.subjects.push(NodeId.fromCaseAuthenticatedTag(cat)));
+      if (fabric === void 0) {
+        throw new MatterFlowError("ACL error: fabric is undefined");
+      }
+      isd.fabricIndex = fabric.fabricIndex;
+    }
+    return isd;
+  }
+}
+export {
+  AccessControlManager,
+  AccessDeniedError
+};
+//# sourceMappingURL=AccessControlManager.js.map

package/dist/esm/interaction/AccessControlManager.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/interaction/AccessControlManager.ts"],
+  "mappings": "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",
+  "names": ["AuthModeNone"]
+}

package/dist/esm/interaction/AttributeDataDecoder.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { AttributeId, ClusterId, EndpointNumber, NodeId, TlvAttributeData, TlvAttributeReport, TlvSchema, TypeFromSchema } from "#types";
+/** Represents a fully qualified and decoded attribute value from a received DataReport */
+export type DecodedAttributeReportValue<T> = {
+    path: {
+        nodeId?: NodeId;
+        endpointId: EndpointNumber;
+        clusterId: ClusterId;
+        attributeId: AttributeId;
+        attributeName: string;
+    };
+    version: number;
+    value: T;
+};
+/** Represents a decoded attribute value from a received DataReport where data version could be optional. */
+export type DecodedAttributeValue<T> = Omit<DecodedAttributeReportValue<T>, "version"> & {
+    version?: number;
+};
+/**
+ * Parses, normalizes (e.g. un-chunk arrays and resolve Tag compression if used) and decodes the attribute data from
+ * a received DataReport.
+ */
+export declare function normalizeAndDecodeReadAttributeReport(data: TypeFromSchema<typeof TlvAttributeReport>[]): DecodedAttributeReportValue<any>[];
+export declare function expandPathsInAttributeData(data: TypeFromSchema<typeof TlvAttributeData>[], acceptWildcardPaths?: boolean): TypeFromSchema<typeof TlvAttributeData>[];
+/**
+ * Normalizes (e.g. prepare data for array un-chinking and resolve Tag compression if used) the attribute details from
+ * a received DataReport.
+ */
+export declare function normalizeAttributeData(data: TypeFromSchema<typeof TlvAttributeData>[], acceptWildcardPaths?: boolean): TypeFromSchema<typeof TlvAttributeData>[][];
+/**
+ * Normalizes (e.g. un-chunk arrays and resolve Tag compression if used) and decodes the attribute data from a received
+ * DataReport.
+ */
+export declare function normalizeAndDecodeAttributeData(data: TypeFromSchema<typeof TlvAttributeData>[]): DecodedAttributeValue<any>[];
+export declare function decodeListAttributeValueWithSchema<T>(schema: TlvSchema<T>, values: TypeFromSchema<typeof TlvAttributeData>[], currentValue?: T): T | undefined;
+/** Decodes the data for one attribute via a schema including array un-chunking. */
+export declare function decodeAttributeValueWithSchema<T>(schema: TlvSchema<T>, values: TypeFromSchema<typeof TlvAttributeData>[], defaultValue?: T): T | undefined;
+/** Decodes the data for one unknown attribute via the AnySchema including array un-chunking. */
+export declare function decodeUnknownAttributeValue(values: TypeFromSchema<typeof TlvAttributeData>[]): any;
+/** Structure the data of a received DataReport into an endpointId/clusterId/attributeName object structure. */
+export declare function structureReadAttributeDataToClusterObject(data: DecodedAttributeReportValue<any>[]): {
+    [key: number]: {
+        [key: number]: {
+            [key: string]: any;
+        };
+    };
+};
+//# sourceMappingURL=AttributeDataDecoder.d.ts.map

package/dist/esm/interaction/AttributeDataDecoder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttributeDataDecoder.d.ts","sourceRoot":"","sources":["../../../src/interaction/AttributeDataDecoder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAIH,WAAW,EAEX,SAAS,EACT,cAAc,EAGd,MAAM,EAEN,gBAAgB,EAChB,kBAAkB,EAClB,SAAS,EACT,cAAc,EACjB,MAAM,QAAQ,CAAC;AAIhB,0FAA0F;AAC1F,MAAM,MAAM,2BAA2B,CAAC,CAAC,IAAI;IACzC,IAAI,EAAE;QACF,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,cAAc,CAAC;QAC3B,SAAS,EAAE,SAAS,CAAC;QACrB,WAAW,EAAE,WAAW,CAAC;QACzB,aAAa,EAAE,MAAM,CAAC;KACzB,CAAC;IACF,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,CAAC,CAAC;CACZ,CAAC;AAEF,4GAA4G;AAC5G,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI,IAAI,CAAC,2BAA2B,CAAC,CAAC,CAAC,EAAE,SAAS,CAAC,GAAG;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,qCAAqC,CACjD,IAAI,EAAE,cAAc,CAAC,OAAO,kBAAkB,CAAC,EAAE,GAClD,2BAA2B,CAAC,GAAG,CAAC,EAAE,CAKpC;AAED,wBAAgB,0BAA0B,CACtC,IAAI,EAAE,cAAc,CAAC,OAAO,gBAAgB,CAAC,EAAE,EAC/C,mBAAmB,UAAQ,GAC5B,cAAc,CAAC,OAAO,gBAAgB,CAAC,EAAE,CAmC3C;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAClC,IAAI,EAAE,cAAc,CAAC,OAAO,gBAAgB,CAAC,EAAE,EAC/C,mBAAmB,UAAQ,GAC5B,cAAc,CAAC,OAAO,gBAAgB,CAAC,EAAE,EAAE,CAgB7C;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAC3C,IAAI,EAAE,cAAc,CAAC,OAAO,gBAAgB,CAAC,EAAE,GAChD,qBAAqB,CAAC,GAAG,CAAC,EAAE,CA8C9B;AAmBD,wBAAgB,kCAAkC,CAAC,CAAC,EAChD,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACpB,MAAM,EAAE,cAAc,CAAC,OAAO,gBAAgB,CAAC,EAAE,EACjD,YAAY,CAAC,EAAE,CAAC,GACjB,CAAC,GAAG,SAAS,CASf;AAED,mFAAmF;AACnF,wBAAgB,8BAA8B,CAAC,CAAC,EAC5C,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,EACpB,MAAM,EAAE,cAAc,CAAC,OAAO,gBAAgB,CAAC,EAAE,EACjD,YAAY,CAAC,EAAE,CAAC,GACjB,CAAC,GAAG,SAAS,CAYf;AAED,gGAAgG;AAChG,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,cAAc,CAAC,OAAO,gBAAgB,CAAC,EAAE,GAAG,GAAG,CAkBlG;AAED,+GAA+G;AAC/G,wBAAgB,yCAAyC,CAAC,IAAI,EAAE,2BAA2B,CAAC,GAAG,CAAC,EAAE;;;;;;EAejG"}

package/dist/esm/interaction/AttributeDataDecoder.js

@@ -0,0 +1,171 @@
+/**
+ * @license
+ * Copyright 2022-2024 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { Diagnostic, Logger, UnexpectedDataError } from "#general";
+import {
+  ArraySchema,
+  AttributeError,
+  getClusterAttributeById,
+  getClusterById,
+  TlvAny
+} from "#types";
+const logger = Logger.get("AttributeDataDecoder");
+function normalizeAndDecodeReadAttributeReport(data) {
+  const dataValues = data.flatMap(({ attributeData }) => attributeData !== void 0 ? attributeData : []);
+  return normalizeAndDecodeAttributeData(dataValues);
+}
+function expandPathsInAttributeData(data, acceptWildcardPaths = false) {
+  let lastPath;
+  data.forEach((value) => {
+    if (value === void 0) return;
+    const { path } = value;
+    if (path.enableTagCompression) {
+      if (lastPath === void 0) throw new UnexpectedDataError("Tag compression enabled, but no previous path");
+      if (path.nodeId === void 0 && lastPath.nodeId !== void 0) path.nodeId = lastPath.nodeId;
+      if (path.endpointId === void 0) path.endpointId = lastPath.endpointId;
+      if (path.clusterId === void 0) path.clusterId = lastPath.clusterId;
+      if (path.attributeId === void 0) path.attributeId = lastPath.attributeId;
+      if (value.dataVersion === void 0 && lastPath.dataVersion !== void 0)
+        value.dataVersion = lastPath.dataVersion;
+    } else if (path.endpointId !== void 0 && path.clusterId !== void 0 && path.attributeId !== void 0) {
+      lastPath = {
+        nodeId: path.nodeId,
+        endpointId: path.endpointId,
+        clusterId: path.clusterId,
+        attributeId: path.attributeId,
+        dataVersion: value.dataVersion
+      };
+    } else if (!acceptWildcardPaths) {
+      throw new UnexpectedDataError("Tag compression disabled, but path is incomplete: " + Logger.toJSON(path));
+    }
+  });
+  return data;
+}
+function normalizeAttributeData(data, acceptWildcardPaths = false) {
+  const expandedData = expandPathsInAttributeData(data, acceptWildcardPaths);
+  const responseList = /* @__PURE__ */ new Map();
+  expandedData.forEach((value) => {
+    if (!value) return;
+    const {
+      path: { nodeId, endpointId, clusterId, attributeId }
+    } = value;
+    const mapId = `${nodeId}-${endpointId}-${clusterId}-${attributeId}`;
+    const list = responseList.get(mapId) || [];
+    list.push(value);
+    responseList.set(mapId, list);
+  });
+  return Array.from(responseList.values());
+}
+function normalizeAndDecodeAttributeData(data) {
+  const responseList = normalizeAttributeData(data);
+  const result = new Array();
+  responseList.forEach((values) => {
+    const {
+      path: { nodeId, endpointId, clusterId, attributeId },
+      dataVersion
+    } = values[0];
+    if (endpointId === void 0 || clusterId === void 0 || attributeId === void 0) {
+      throw new UnexpectedDataError(`Invalid attribute path ${endpointId}/${clusterId}/${attributeId}`);
+    }
+    try {
+      const cluster = getClusterById(clusterId);
+      const attributeDetail = getClusterAttributeById(cluster, attributeId);
+      if (attributeDetail === void 0) {
+        logger.debug(
+          `Decode unknown attribute ${Diagnostic.hex(clusterId)}/${Diagnostic.hex(attributeId)} via the AnySchema.`
+        );
+        const attributeName = `Unknown (${Diagnostic.hex(attributeId)})`;
+        const value2 = decodeUnknownAttributeValue(values);
+        result.push({
+          path: { nodeId, endpointId, clusterId, attributeId, attributeName },
+          version: dataVersion,
+          value: value2
+        });
+        return;
+      }
+      const { attribute, name } = attributeDetail;
+      const value = decodeValueForAttribute(attribute, values);
+      result.push({
+        path: { nodeId, endpointId, clusterId, attributeId, attributeName: name },
+        version: dataVersion,
+        value
+      });
+    } catch (error) {
+      logger.error(
+        `Error decoding attribute ${endpointId}/${Diagnostic.hex(clusterId)}/${Diagnostic.hex(attributeId)}: ${error.message}`
+      );
+    }
+  });
+  return result;
+}
+function decodeValueForAttribute(attribute, values) {
+  const { schema, optional, default: conformanceValue } = attribute;
+  if (!values.length) {
+    if (optional) return void 0;
+    if (conformanceValue === void 0) throw new AttributeError(`Attribute not found.`);
+    return conformanceValue;
+  }
+  return decodeAttributeValueWithSchema(schema, values);
+}
+function decodeListAttributeValueWithSchema(schema, values, currentValue) {
+  if (!(schema instanceof ArraySchema)) {
+    throw new UnexpectedDataError(`Attribute is not an list but multiple values were returned.`);
+  }
+  return schema.decodeFromChunkedArray(
+    values.map(({ data, path: { listIndex } }) => ({ listIndex, element: data })),
+    currentValue
+  );
+}
+function decodeAttributeValueWithSchema(schema, values, defaultValue) {
+  if (!values.length) {
+    return defaultValue;
+  }
+  if (values.length === 1 && values[0].path.listIndex === void 0) {
+    return schema.decodeTlv(values[0].data);
+  }
+  return decodeListAttributeValueWithSchema(schema, values, defaultValue);
+}
+function decodeUnknownAttributeValue(values) {
+  const schema = TlvAny;
+  if (!values.length) {
+    return void 0;
+  }
+  if (values.length === 1 && values[0].path.listIndex === void 0) {
+    const tlvEncoded = schema.decodeTlv(values[0].data);
+    return schema.decodeAnyTlvStream(tlvEncoded);
+  } else {
+    const tlvEncoded = new ArraySchema(schema).decodeFromChunkedArray(
+      values.map(({ data, path: { listIndex } }) => ({ listIndex, element: data }))
+    );
+    return tlvEncoded.map((element) => schema.decodeAnyTlvStream(element));
+  }
+}
+function structureReadAttributeDataToClusterObject(data) {
+  const structure = {};
+  for (const {
+    path: { endpointId, clusterId, attributeName },
+    value
+  } of data) {
+    if (structure[endpointId] === void 0) {
+      structure[endpointId] = {};
+    }
+    if (structure[endpointId][clusterId] === void 0) {
+      structure[endpointId][clusterId] = {};
+    }
+    structure[endpointId][clusterId][attributeName] = value;
+  }
+  return structure;
+}
+export {
+  decodeAttributeValueWithSchema,
+  decodeListAttributeValueWithSchema,
+  decodeUnknownAttributeValue,
+  expandPathsInAttributeData,
+  normalizeAndDecodeAttributeData,
+  normalizeAndDecodeReadAttributeReport,
+  normalizeAttributeData,
+  structureReadAttributeDataToClusterObject
+};
+//# sourceMappingURL=AttributeDataDecoder.js.map

package/dist/esm/interaction/AttributeDataDecoder.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/interaction/AttributeDataDecoder.ts"],
+  "mappings": "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",
+  "names": ["value"]
+}