@matter/node 0.17.0-alpha.0-20260518-7f13c7285 → 0.17.0

package/src/behaviors/groups/GroupsServer.ts

@@ -11,7 +11,7 @@ import { Endpoint } from "#endpoint/Endpoint.js";
 import { RootEndpoint } from "#endpoints/root";
 import { InternalError, Logger } from "@matter/general";
 import { assertRemoteActor, Fabric } from "@matter/protocol";
-import { StatusCode, StatusResponseError } from "@matter/types";
+import { Status, StatusResponseError } from "@matter/types";
 import { Groups } from "@matter/types/clusters/groups";
 import { GroupsBehavior } from "./GroupsBehavior.js";
 
@@ -86,14 +86,14 @@ export class GroupsServer extends GroupsBase {
         const fabric = this.context.session.associatedFabric;
 
         if (groupId < 1) {
-            return { status: StatusCode.ConstraintError, groupId };
+            return { status: Status.ConstraintError, groupId };
         }
         if (groupName.length > 16) {
-            return { status: StatusCode.ConstraintError, groupId };
+            return { status: Status.ConstraintError, groupId };
         }
 
         if (!fabric.groups.groupKeyIdMap.has(groupId)) {
-            return { status: StatusCode.UnsupportedAccess, groupId };
+            return { status: Status.UnsupportedAccess, groupId };
         }
 
         const endpointNumber = this.endpoint.number;
@@ -108,7 +108,7 @@ export class GroupsServer extends GroupsBase {
             return { status: error.code, groupId };
         }
 
-        return { status: StatusCode.Success, groupId };
+        return { status: Status.Success, groupId };
     }
 
     override viewGroup({ groupId }: Groups.ViewGroupRequest): Groups.ViewGroupResponse {
@@ -116,7 +116,7 @@ export class GroupsServer extends GroupsBase {
         const fabric = this.context.session.associatedFabric;
 
         if (groupId < 1) {
-            return { status: StatusCode.ConstraintError, groupId, groupName: "" };
+            return { status: Status.ConstraintError, groupId, groupName: "" };
         }
 
         const fabricIndex = fabric.fabricIndex;
@@ -125,9 +125,9 @@ export class GroupsServer extends GroupsBase {
         const { groupTable } = this.#rootEndpoint.stateOf(GroupKeyManagementServer);
         const groupEntry = groupTable.find(entry => entry.groupId === groupId && entry.fabricIndex === fabricIndex);
         if (groupEntry === undefined || !groupEntry.endpoints.includes(endpointNumber)) {
-            return { status: StatusCode.NotFound, groupId, groupName: "" };
+            return { status: Status.NotFound, groupId, groupName: "" };
         }
-        return { status: StatusCode.Success, groupId, groupName: groupEntry.groupName ?? "" };
+        return { status: Status.Success, groupId, groupName: groupEntry.groupName ?? "" };
     }
 
     override async getGroupMembership({
@@ -154,7 +154,7 @@ export class GroupsServer extends GroupsBase {
 
     override async removeGroup({ groupId }: Groups.RemoveGroupRequest): Promise<Groups.RemoveGroupResponse> {
         if (groupId < 1) {
-            return { status: StatusCode.ConstraintError, groupId };
+            return { status: Status.ConstraintError, groupId };
         }
 
         try {
@@ -169,9 +169,9 @@ export class GroupsServer extends GroupsBase {
                         .get(ScenesManagementServer)
                         .removeScenesForGroupOnFabric(this.context.session.associatedFabric.fabricIndex, groupId);
                 }
-                return { status: StatusCode.Success, groupId };
+                return { status: Status.Success, groupId };
             }
-            return { status: StatusCode.NotFound, groupId };
+            return { status: Status.NotFound, groupId };
         } catch (error) {
             StatusResponseError.accept(error);
             return { status: error.code, groupId };
@@ -197,7 +197,7 @@ export class GroupsServer extends GroupsBase {
         if (this.endpoint.stateOf(IdentifyBehavior).identifyTime > 0) {
             // We identify ourselves currently
             const { status } = await this.addGroup({ groupId, groupName });
-            if (status !== StatusCode.Success) {
+            if (status !== Status.Success) {
                 throw new StatusResponseError(`Failed to add group ${groupId}`, status);
             }
         }

package/src/behaviors/level-control/LevelControlServer.ts

@@ -16,7 +16,7 @@ import { AggregatorEndpoint } from "#endpoints/aggregator";
 import { ServerNode } from "#node/ServerNode.js";
 import { AsyncObservable, cropValueRange, Identity, Logger, MaybePromise, Millis } from "@matter/general";
 import { Val } from "@matter/protocol";
-import { StatusCode, StatusResponseError } from "@matter/types";
+import { Status, StatusResponseError } from "@matter/types";
 import { GeneralDiagnostics } from "@matter/types/clusters/general-diagnostics";
 import { LevelControl } from "@matter/types/clusters/level-control";
 import { LevelControlBehavior } from "./LevelControlBehavior.js";
@@ -79,7 +79,7 @@ export class LevelControlBaseServer extends LevelControlBase {
         if (this.state.currentLevel === null) {
             throw new StatusResponseError(
                 "The currentLevel value is null, so we cannot operate on it.",
-                StatusCode.Failure,
+                Status.Failure,
             );
         }
         return this.state.currentLevel;
@@ -269,7 +269,7 @@ export class LevelControlBaseServer extends LevelControlBase {
      */
     #assertRateValue(rate: number | null) {
         if (rate === 0) {
-            throw new StatusResponseError(`Illegal move rate of 0`, StatusCode.InvalidCommand);
+            throw new StatusResponseError(`Illegal move rate of 0`, Status.InvalidCommand);
         }
         if (rate === null) {
             return this.state.defaultMoveRate ?? null;

package/src/behaviors/mode-select/ModeSelectServer.ts

@@ -8,7 +8,7 @@ import { GeneralDiagnosticsBehavior } from "#behaviors/general-diagnostics";
 import { OnOffServer } from "#behaviors/on-off";
 import { ServerNode } from "#node/ServerNode.js";
 import { Logger, MaybePromise } from "@matter/general";
-import { StatusCode, StatusResponseError } from "@matter/types";
+import { Status, StatusResponseError } from "@matter/types";
 import { GeneralDiagnostics } from "@matter/types/clusters/general-diagnostics";
 import { ModeSelect } from "@matter/types/clusters/mode-select";
 import { OnOff } from "@matter/types/clusters/on-off";
@@ -89,7 +89,7 @@ export class ModeSelectBaseServer extends ModeSelectBase {
         if (!this.state.supportedModes.some(({ mode: supportedMode }) => supportedMode === mode)) {
             throw new StatusResponseError(
                 `Mode ${mode} provided in ${fieldName} is not supported`,
-                StatusCode.InvalidCommand,
+                Status.InvalidCommand,
             );
         }
     }

package/src/behaviors/operational-credentials/OperationalCredentialsServer.ts

@@ -36,7 +36,7 @@ import {
 } from "@matter/protocol";
 import {
     FabricIndex,
-    StatusCode,
+    Status,
     StatusResponse,
     StatusResponseError,
     SubjectId,
@@ -95,7 +95,7 @@ export class OperationalCredentialsServer extends OperationalCredentialsBase {
         assertRemoteActor(this.context);
 
         if (attestationNonce.byteLength !== 32) {
-            throw new StatusResponseError("Invalid attestation nonce length", StatusCode.InvalidCommand);
+            throw new StatusResponseError("Invalid attestation nonce length", Status.InvalidCommand);
         }
 
         const certification = await this.getCertification();
@@ -118,16 +118,13 @@ export class OperationalCredentialsServer extends OperationalCredentialsBase {
         assertRemoteActor(this.context);
 
         if (csrNonce.byteLength !== 32) {
-            throw new StatusResponseError("Invalid csr nonce length", StatusCode.InvalidCommand);
+            throw new StatusResponseError("Invalid csr nonce length", Status.InvalidCommand);
         }
 
         const session = this.context.session;
         NodeSession.assert(session);
         if (isForUpdateNoc && session.isPase) {
-            throw new StatusResponseError(
-                "csrRequest for UpdateNoc received on a PASE session",
-                StatusCode.InvalidCommand,
-            );
+            throw new StatusResponseError("csrRequest for UpdateNoc received on a PASE session", Status.InvalidCommand);
         }
 
         const commissioner = this.env.get(DeviceCommissioner);
@@ -135,7 +132,7 @@ export class OperationalCredentialsServer extends OperationalCredentialsBase {
         if (failsafeContext.fabricIndex !== undefined) {
             throw new StatusResponseError(
                 `csrRequest received after ${failsafeContext.forUpdateNoc ? "UpdateNOC" : "AddNOC"} already invoked`,
-                StatusCode.ConstraintError,
+                Status.ConstraintError,
             );
         }
 
@@ -162,7 +159,7 @@ export class OperationalCredentialsServer extends OperationalCredentialsBase {
             default:
                 throw new StatusResponseError(
                     `Unsupported certificate type: ${certificateType}`,
-                    StatusCode.InvalidCommand,
+                    Status.InvalidCommand,
                 );
         }
     }
@@ -216,7 +213,7 @@ export class OperationalCredentialsServer extends OperationalCredentialsBase {
         if (failsafeContext.fabricIndex !== undefined) {
             throw new StatusResponseError(
                 `AddNoc is illegal after ${failsafeContext.forUpdateNoc ? "UpdateNOC" : "AddNOC"} in the same failsafe context`,
-                StatusCode.ConstraintError,
+                Status.ConstraintError,
             );
         }
 
@@ -237,7 +234,7 @@ export class OperationalCredentialsServer extends OperationalCredentialsBase {
         if (failsafeContext.forUpdateNoc) {
             throw new StatusResponseError(
                 `AddNoc is illegal after CsrRequest for UpdateNOC in same failsafe context`,
-                StatusCode.ConstraintError,
+                Status.ConstraintError,
             );
         }
 
@@ -316,14 +313,14 @@ export class OperationalCredentialsServer extends OperationalCredentialsBase {
         if (timedOp.fabricIndex !== undefined) {
             throw new StatusResponseError(
                 `UpdateNoc is illegal after ${timedOp.forUpdateNoc ? "UpdateNOC" : "AddNOC"} in same failsafe context`,
-                StatusCode.ConstraintError,
+                Status.ConstraintError,
             );
         }
 
         if (timedOp.forUpdateNoc === false) {
             throw new StatusResponseError(
                 "UpdateNoc is illegal after CsrRequest for AddNOC in same failsafe context",
-                StatusCode.ConstraintError,
+                Status.ConstraintError,
             );
         }
 
@@ -348,7 +345,7 @@ export class OperationalCredentialsServer extends OperationalCredentialsBase {
         if (this.context.session.associatedFabric.fabricIndex !== timedOp.associatedFabric?.fabricIndex) {
             throw new StatusResponseError(
                 "Fabric of this session and the failsafe context do not match",
-                StatusCode.ConstraintError,
+                Status.ConstraintError,
             );
         }
 
@@ -427,14 +424,14 @@ export class OperationalCredentialsServer extends OperationalCredentialsBase {
         if (failsafeContext.rootCertSet) {
             throw new StatusResponseError(
                 "Trusted root certificate already added in this FailSafe context",
-                StatusCode.ConstraintError,
+                Status.ConstraintError,
             );
         }
 
         if (failsafeContext.fabricIndex !== undefined) {
             throw new StatusResponseError(
                 `Cannot add trusted root certificates after ${failsafeContext.forUpdateNoc ? "UpdateNOC" : "AddNOC"}`,
-                StatusCode.ConstraintError,
+                Status.ConstraintError,
             );
         }
 
@@ -448,7 +445,7 @@ export class OperationalCredentialsServer extends OperationalCredentialsBase {
                 error instanceof ValidationError ||
                 error instanceof UnexpectedDataError
             ) {
-                throw new StatusResponseError(error.message, StatusCode.InvalidCommand);
+                throw new StatusResponseError(error.message, Status.InvalidCommand);
             }
             throw error;
         }

package/src/behaviors/switch/SwitchServer.ts

@@ -7,7 +7,7 @@
 import { ActionContext } from "#behavior/context/ActionContext.js";
 import { Duration, Logger, MaybePromise, Millis, Observable, Seconds, Time, Timer } from "@matter/general";
 import { FieldElement } from "@matter/model";
-import { StatusCode, StatusResponseError } from "@matter/types";
+import { Status, StatusResponseError } from "@matter/types";
 import { Switch } from "@matter/types/clusters/switch";
 import { SwitchBehavior } from "./SwitchBehavior.js";
 
@@ -110,7 +110,7 @@ export class SwitchBaseServer extends SwitchServerBase {
     // TODO remove when Validator logic can assess that with 1.3 introduction
     #assertPositionInRange(position: number) {
         if (position < 0 || position >= this.state.numberOfPositions) {
-            throw new StatusResponseError(`Position ${position} invalid`, StatusCode.ConstraintError);
+            throw new StatusResponseError(`Position ${position} invalid`, Status.ConstraintError);
         }
     }
 

package/src/behaviors/window-covering/WindowCoveringServer.ts

@@ -5,7 +5,7 @@
  */
 
 import { Diagnostic, ImplementationError, isDeepEqual, Logger, MaybePromise, Worker } from "@matter/general";
-import { StatusCode, StatusResponseError } from "@matter/types";
+import { Status, StatusResponseError } from "@matter/types";
 import { WindowCovering } from "@matter/types/clusters/window-covering";
 import { WindowCoveringBehavior } from "./WindowCoveringBehavior.js";
 
@@ -165,13 +165,13 @@ export class WindowCoveringBaseServer extends WindowCoveringBase {
             mode.calibrationMode = false;
         }
         if (mode.maintenanceMode && !this.state.supportsMaintenanceMode) {
-            throw new StatusResponseError("Maintenance mode not supported", StatusCode.ConstraintError);
+            throw new StatusResponseError("Maintenance mode not supported", Status.ConstraintError);
         }
         this.internal.inMaintenanceMode = !!mode.maintenanceMode;
 
         if (mode.calibrationMode) {
             if (!this.internal.supportsCalibration) {
-                throw new StatusResponseError("Calibration not supported", StatusCode.ConstraintError);
+                throw new StatusResponseError("Calibration not supported", Status.ConstraintError);
             }
             if (this.internal.calibrationMode === CalibrationMode.Running) {
                 // What to do here? For now lets leave unchanged
@@ -286,14 +286,14 @@ export class WindowCoveringBaseServer extends WindowCoveringBase {
      */
     #assertMotionLockStatus() {
         if (this.internal.inMaintenanceMode) {
-            throw new StatusResponseError("Device is in maintenance mode", StatusCode.Busy);
+            throw new StatusResponseError("Device is in maintenance mode", Status.Busy);
         }
 
         switch (this.internal.calibrationMode) {
             case CalibrationMode.Enabled:
                 if (!this.internal.supportsCalibration) {
                     // Should never happy normally because mode attribute should never be set
-                    throw new StatusResponseError("Calibration not implemented", StatusCode.Failure);
+                    throw new StatusResponseError("Calibration not implemented", Status.Failure);
                 }
                 break;
             case CalibrationMode.Running:
@@ -304,7 +304,7 @@ export class WindowCoveringBaseServer extends WindowCoveringBase {
         }
 
         if (!this.state.configStatus.operational) {
-            throw new StatusResponseError("Device is not operational", StatusCode.Failure);
+            throw new StatusResponseError("Device is not operational", Status.Failure);
         }
     }
 

package/src/devices/closure-panel.ts

@@ -9,8 +9,6 @@
 import {
     ClosureDimensionServer as BaseClosureDimensionServer
 } from "../behaviors/closure-dimension/ClosureDimensionServer.js";
-import { WindowCoveringServer as BaseWindowCoveringServer } from "../behaviors/window-covering/WindowCoveringServer.js";
-import { ClosureControlServer as BaseClosureControlServer } from "../behaviors/closure-control/ClosureControlServer.js";
 import { MutableEndpoint } from "../endpoint/type/MutableEndpoint.js";
 import { SupportedBehaviors } from "../endpoint/properties/SupportedBehaviors.js";
 import { Identity } from "@matter/general";
@@ -45,27 +43,10 @@ export namespace ClosurePanelRequirements {
      */
     export const ClosureDimensionServer = BaseClosureDimensionServer;
 
-    /**
-     * The WindowCovering cluster is optional per the Matter specification.
-     *
-     * We provide this alias to the default implementation {@link WindowCoveringServer} for convenience.
-     */
-    export const WindowCoveringServer = BaseWindowCoveringServer;
-
-    /**
-     * The ClosureControl cluster is optional per the Matter specification.
-     *
-     * We provide this alias to the default implementation {@link ClosureControlServer} for convenience.
-     */
-    export const ClosureControlServer = BaseClosureControlServer;
-
     /**
      * An implementation for each server cluster supported by the endpoint per the Matter specification.
      */
-    export const server = {
-        mandatory: { ClosureDimension: ClosureDimensionServer },
-        optional: { WindowCovering: WindowCoveringServer, ClosureControl: ClosureControlServer }
-    };
+    export const server = { mandatory: { ClosureDimension: ClosureDimensionServer } };
 }
 
 export const ClosurePanelDeviceDefinition = MutableEndpoint({

package/src/devices/closure.ts

@@ -8,10 +8,6 @@
 
 import { IdentifyServer as BaseIdentifyServer } from "../behaviors/identify/IdentifyServer.js";
 import { ClosureControlServer as BaseClosureControlServer } from "../behaviors/closure-control/ClosureControlServer.js";
-import { WindowCoveringServer as BaseWindowCoveringServer } from "../behaviors/window-covering/WindowCoveringServer.js";
-import {
-    ClosureDimensionServer as BaseClosureDimensionServer
-} from "../behaviors/closure-dimension/ClosureDimensionServer.js";
 import { MutableEndpoint } from "../endpoint/type/MutableEndpoint.js";
 import { SupportedBehaviors } from "../endpoint/properties/SupportedBehaviors.js";
 import { Identity } from "@matter/general";
@@ -46,27 +42,10 @@ export namespace ClosureRequirements {
      */
     export const ClosureControlServer = BaseClosureControlServer;
 
-    /**
-     * The WindowCovering cluster is optional per the Matter specification.
-     *
-     * We provide this alias to the default implementation {@link WindowCoveringServer} for convenience.
-     */
-    export const WindowCoveringServer = BaseWindowCoveringServer;
-
-    /**
-     * The ClosureDimension cluster is optional per the Matter specification.
-     *
-     * We provide this alias to the default implementation {@link ClosureDimensionServer} for convenience.
-     */
-    export const ClosureDimensionServer = BaseClosureDimensionServer;
-
     /**
      * An implementation for each server cluster supported by the endpoint per the Matter specification.
      */
-    export const server = {
-        mandatory: { Identify: IdentifyServer, ClosureControl: ClosureControlServer },
-        optional: { WindowCovering: WindowCoveringServer, ClosureDimension: ClosureDimensionServer }
-    };
+    export const server = { mandatory: { Identify: IdentifyServer, ClosureControl: ClosureControlServer } };
 }
 
 export const ClosureDeviceDefinition = MutableEndpoint({

package/src/devices/door-lock.ts

@@ -8,10 +8,6 @@
 
 import { IdentifyServer as BaseIdentifyServer } from "../behaviors/identify/IdentifyServer.js";
 import { DoorLockServer as BaseDoorLockServer } from "../behaviors/door-lock/DoorLockServer.js";
-import { GroupsServer as BaseGroupsServer } from "../behaviors/groups/GroupsServer.js";
-import {
-    ScenesManagementServer as BaseScenesManagementServer
-} from "../behaviors/scenes-management/ScenesManagementServer.js";
 import { MutableEndpoint } from "../endpoint/type/MutableEndpoint.js";
 import { SupportedBehaviors } from "../endpoint/properties/SupportedBehaviors.js";
 import { Identity } from "@matter/general";
@@ -39,27 +35,10 @@ export namespace DoorLockRequirements {
      */
     export const DoorLockServer = BaseDoorLockServer;
 
-    /**
-     * The Groups cluster is optional per the Matter specification.
-     *
-     * We provide this alias to the default implementation {@link GroupsServer} for convenience.
-     */
-    export const GroupsServer = BaseGroupsServer;
-
-    /**
-     * The ScenesManagement cluster is optional per the Matter specification.
-     *
-     * We provide this alias to the default implementation {@link ScenesManagementServer} for convenience.
-     */
-    export const ScenesManagementServer = BaseScenesManagementServer;
-
     /**
      * An implementation for each server cluster supported by the endpoint per the Matter specification.
      */
-    export const server = {
-        mandatory: { Identify: IdentifyServer, DoorLock: DoorLockServer },
-        optional: { Groups: GroupsServer, ScenesManagement: ScenesManagementServer }
-    };
+    export const server = { mandatory: { Identify: IdentifyServer, DoorLock: DoorLockServer } };
 }
 
 export const DoorLockDeviceDefinition = MutableEndpoint({

package/src/devices/window-covering.ts

@@ -9,10 +9,6 @@
 import { IdentifyServer as BaseIdentifyServer } from "../behaviors/identify/IdentifyServer.js";
 import { WindowCoveringServer as BaseWindowCoveringServer } from "../behaviors/window-covering/WindowCoveringServer.js";
 import { GroupsServer as BaseGroupsServer } from "../behaviors/groups/GroupsServer.js";
-import { ClosureControlServer as BaseClosureControlServer } from "../behaviors/closure-control/ClosureControlServer.js";
-import {
-    ClosureDimensionServer as BaseClosureDimensionServer
-} from "../behaviors/closure-dimension/ClosureDimensionServer.js";
 import { MutableEndpoint } from "../endpoint/type/MutableEndpoint.js";
 import { SupportedBehaviors } from "../endpoint/properties/SupportedBehaviors.js";
 import { Identity } from "@matter/general";
@@ -49,30 +45,12 @@ export namespace WindowCoveringRequirements {
      */
     export const GroupsServer = BaseGroupsServer;
 
-    /**
-     * The ClosureControl cluster is optional per the Matter specification.
-     *
-     * We provide this alias to the default implementation {@link ClosureControlServer} for convenience.
-     */
-    export const ClosureControlServer = BaseClosureControlServer;
-
-    /**
-     * The ClosureDimension cluster is optional per the Matter specification.
-     *
-     * We provide this alias to the default implementation {@link ClosureDimensionServer} for convenience.
-     */
-    export const ClosureDimensionServer = BaseClosureDimensionServer;
-
     /**
      * An implementation for each server cluster supported by the endpoint per the Matter specification.
      */
     export const server = {
         mandatory: { Identify: IdentifyServer, WindowCovering: WindowCoveringServer },
-        optional: {
-            Groups: GroupsServer,
-            ClosureControl: ClosureControlServer,
-            ClosureDimension: ClosureDimensionServer
-        }
+        optional: { Groups: GroupsServer }
     };
 }
 

package/src/endpoint/type/MutableEndpoint.ts

@@ -6,13 +6,10 @@
 
 import { Behavior } from "#behavior/Behavior.js";
 import { isClientBehavior } from "#behavior/cluster/cluster-behavior-utils.js";
-import { Logger } from "@matter/general";
 import { SupportedBehaviors } from "../properties/SupportedBehaviors.js";
 import { SupportedClientClusters } from "../properties/SupportedClientClusters.js";
 import { EndpointType } from "./EndpointType.js";
 
-const logger = Logger.get("MutableEndpoint");
-
 /**
  * A MutableEndpoint is an EndpointType with factory functions that make it convenient to reconfigure the endpoint.
  *
@@ -58,12 +55,8 @@ export function MutableEndpoint<const T extends EndpointType.Options>(options: T
     const mandatoryClients: SupportedBehaviors = options.requirements?.client?.mandatory ?? {};
     if (Object.keys(mandatoryClients).length > 0) {
         const merged = SupportedClientClusters.extend(clientClusters, Object.values(mandatoryClients));
-        const added = Object.keys(merged).filter(k => !(k in clientClusters));
-        if (added.length > 0) {
+        if (Object.keys(merged).some(k => !(k in clientClusters))) {
             clientClusters = merged;
-            logger.debug(
-                `Auto-registered mandatory client cluster(s) [${added.join(", ")}] for device type ${type.name}`,
-            );
         }
     }