@matter/node 0.16.0-alpha.0-20250812-285b75d83 → 0.16.0-alpha.0-20250815-ac9fd6eb0

package/dist/esm/devices/water-heater.d.ts

@@ -288,9 +288,9 @@ export declare namespace WaterHeaterRequirements {
                         }>>;
                     }>[], any>;
                     readonly numberOfPresets: import("@matter/types").FixedAttribute<number, any>;
-                    readonly activePresetHandle: import("@matter/types").Attribute<Uint8Array<ArrayBufferLike> | null, any>;
+                    readonly activePresetHandle: import("@matter/types").Attribute<AllowSharedBufferSource | null, any>;
                     readonly presets: import("@matter/types").WritableAttribute<import("@matter/types").TypeFromFields<{
-                        presetHandle: import("@matter/types").FieldType<Uint8Array<ArrayBufferLike> | null>;
+                        presetHandle: import("@matter/types").FieldType<AllowSharedBufferSource | null>;
                         presetScenario: import("@matter/types").FieldType<import("@matter/types/clusters/thermostat").Thermostat.PresetScenario>;
                         name: import("@matter/types").OptionalFieldType<string | null>;
                         coolingSetpoint: import("@matter/types").OptionalFieldType<number>;
@@ -300,7 +300,7 @@ export declare namespace WaterHeaterRequirements {
                 };
                 readonly commands: {
                     readonly setActivePresetRequest: import("@matter/types").Command<import("@matter/types").TypeFromFields<{
-                        presetHandle: import("@matter/types").FieldType<Uint8Array<ArrayBufferLike> | null>;
+                        presetHandle: import("@matter/types").FieldType<AllowSharedBufferSource | null>;
                     }>, void, any>;
                 };
             };
@@ -323,12 +323,12 @@ export declare namespace WaterHeaterRequirements {
                     readonly numberOfSchedules: import("@matter/types").FixedAttribute<number, any>;
                     readonly numberOfScheduleTransitions: import("@matter/types").FixedAttribute<number, any>;
                     readonly numberOfScheduleTransitionPerDay: import("@matter/types").FixedAttribute<number | null, any>;
-                    readonly activeScheduleHandle: import("@matter/types").Attribute<Uint8Array<ArrayBufferLike> | null, any>;
+                    readonly activeScheduleHandle: import("@matter/types").Attribute<AllowSharedBufferSource | null, any>;
                     readonly schedules: import("@matter/types").WritableAttribute<import("@matter/types").TypeFromFields<{
-                        scheduleHandle: import("@matter/types").FieldType<Uint8Array<ArrayBufferLike> | null>;
+                        scheduleHandle: import("@matter/types").FieldType<AllowSharedBufferSource | null>;
                         systemMode: import("@matter/types").FieldType<import("@matter/types/clusters/thermostat").Thermostat.SystemMode>;
                         name: import("@matter/types").OptionalFieldType<string>;
-                        presetHandle: import("@matter/types").OptionalFieldType<Uint8Array<ArrayBufferLike>>;
+                        presetHandle: import("@matter/types").OptionalFieldType<AllowSharedBufferSource>;
                         transitions: import("@matter/types").FieldType<import("@matter/types").TypeFromFields<{
                             dayOfWeek: import("@matter/types").FieldType<import("@matter/types").TypeFromPartialBitSchema<{
                                 sunday: import("@matter/types").BitFlag;
@@ -341,7 +341,7 @@ export declare namespace WaterHeaterRequirements {
                                 away: import("@matter/types").BitFlag;
                             }>>;
                             transitionTime: import("@matter/types").FieldType<number>;
-                            presetHandle: import("@matter/types").OptionalFieldType<Uint8Array<ArrayBufferLike>>;
+                            presetHandle: import("@matter/types").OptionalFieldType<AllowSharedBufferSource>;
                             systemMode: import("@matter/types").OptionalFieldType<import("@matter/types/clusters/thermostat").Thermostat.SystemMode>;
                             coolingSetpoint: import("@matter/types").OptionalFieldType<number>;
                             heatingSetpoint: import("@matter/types").OptionalFieldType<number>;
@@ -351,7 +351,7 @@ export declare namespace WaterHeaterRequirements {
                 };
                 readonly commands: {
                     readonly setActiveScheduleRequest: import("@matter/types").Command<import("@matter/types").TypeFromFields<{
-                        scheduleHandle: import("@matter/types").FieldType<Uint8Array<ArrayBufferLike>>;
+                        scheduleHandle: import("@matter/types").FieldType<AllowSharedBufferSource>;
                     }>, void, any>;
                 };
             };
@@ -660,9 +660,9 @@ export declare namespace WaterHeaterRequirements {
                                 }>>;
                             }>[], any>;
                             readonly numberOfPresets: import("@matter/types").FixedAttribute<number, any>;
-                            readonly activePresetHandle: import("@matter/types").Attribute<Uint8Array<ArrayBufferLike> | null, any>;
+                            readonly activePresetHandle: import("@matter/types").Attribute<AllowSharedBufferSource | null, any>;
                             readonly presets: import("@matter/types").WritableAttribute<import("@matter/types").TypeFromFields<{
-                                presetHandle: import("@matter/types").FieldType<Uint8Array<ArrayBufferLike> | null>;
+                                presetHandle: import("@matter/types").FieldType<AllowSharedBufferSource | null>;
                                 presetScenario: import("@matter/types").FieldType<import("@matter/types/clusters/thermostat").Thermostat.PresetScenario>;
                                 name: import("@matter/types").OptionalFieldType<string | null>;
                                 coolingSetpoint: import("@matter/types").OptionalFieldType<number>;
@@ -672,7 +672,7 @@ export declare namespace WaterHeaterRequirements {
                         };
                         readonly commands: {
                             readonly setActivePresetRequest: import("@matter/types").Command<import("@matter/types").TypeFromFields<{
-                                presetHandle: import("@matter/types").FieldType<Uint8Array<ArrayBufferLike> | null>;
+                                presetHandle: import("@matter/types").FieldType<AllowSharedBufferSource | null>;
                             }>, void, any>;
                         };
                     };
@@ -695,12 +695,12 @@ export declare namespace WaterHeaterRequirements {
                             readonly numberOfSchedules: import("@matter/types").FixedAttribute<number, any>;
                             readonly numberOfScheduleTransitions: import("@matter/types").FixedAttribute<number, any>;
                             readonly numberOfScheduleTransitionPerDay: import("@matter/types").FixedAttribute<number | null, any>;
-                            readonly activeScheduleHandle: import("@matter/types").Attribute<Uint8Array<ArrayBufferLike> | null, any>;
+                            readonly activeScheduleHandle: import("@matter/types").Attribute<AllowSharedBufferSource | null, any>;
                             readonly schedules: import("@matter/types").WritableAttribute<import("@matter/types").TypeFromFields<{
-                                scheduleHandle: import("@matter/types").FieldType<Uint8Array<ArrayBufferLike> | null>;
+                                scheduleHandle: import("@matter/types").FieldType<AllowSharedBufferSource | null>;
                                 systemMode: import("@matter/types").FieldType<import("@matter/types/clusters/thermostat").Thermostat.SystemMode>;
                                 name: import("@matter/types").OptionalFieldType<string>;
-                                presetHandle: import("@matter/types").OptionalFieldType<Uint8Array<ArrayBufferLike>>;
+                                presetHandle: import("@matter/types").OptionalFieldType<AllowSharedBufferSource>;
                                 transitions: import("@matter/types").FieldType<import("@matter/types").TypeFromFields<{
                                     dayOfWeek: import("@matter/types").FieldType<import("@matter/types").TypeFromPartialBitSchema<{
                                         sunday: import("@matter/types").BitFlag;
@@ -713,7 +713,7 @@ export declare namespace WaterHeaterRequirements {
                                         away: import("@matter/types").BitFlag;
                                     }>>;
                                     transitionTime: import("@matter/types").FieldType<number>;
-                                    presetHandle: import("@matter/types").OptionalFieldType<Uint8Array<ArrayBufferLike>>;
+                                    presetHandle: import("@matter/types").OptionalFieldType<AllowSharedBufferSource>;
                                     systemMode: import("@matter/types").OptionalFieldType<import("@matter/types/clusters/thermostat").Thermostat.SystemMode>;
                                     coolingSetpoint: import("@matter/types").OptionalFieldType<number>;
                                     heatingSetpoint: import("@matter/types").OptionalFieldType<number>;
@@ -723,7 +723,7 @@ export declare namespace WaterHeaterRequirements {
                         };
                         readonly commands: {
                             readonly setActiveScheduleRequest: import("@matter/types").Command<import("@matter/types").TypeFromFields<{
-                                scheduleHandle: import("@matter/types").FieldType<Uint8Array<ArrayBufferLike>>;
+                                scheduleHandle: import("@matter/types").FieldType<AllowSharedBufferSource>;
                             }>, void, any>;
                         };
                     };

package/dist/esm/node/server/InteractionServer.js

@@ -579,7 +579,7 @@ class InteractionServer {
       // Assume for now we have multiple responses when having multiple invokes
     };
     const emptyInvokeResponseBytes = TlvInvokeResponseForSend.encode(invokeResponseMessage);
-    let messageSize = emptyInvokeResponseBytes.length;
+    let messageSize = emptyInvokeResponseBytes.byteLength;
     let invokeResultsProcessed = 0;
     const processResponseResult = async (invokeResponse) => {
       invokeResultsProcessed++;
@@ -617,7 +617,7 @@ class InteractionServer {
             }
           );
           invokeResponseMessage.invokeResponses = [];
-          messageSize = emptyInvokeResponseBytes.length;
+          messageSize = emptyInvokeResponseBytes.byteLength;
         }
         if (!lastMessageProcessed) {
           invokeResultsProcessed--;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@matter/node",
-    "version": "0.16.0-alpha.0-20250812-285b75d83",
+    "version": "0.16.0-alpha.0-20250815-ac9fd6eb0",
     "description": "API for building Matter nodes",
     "keywords": [
         "iot",
@@ -42,14 +42,14 @@
         "#*": "./src/*"
     },
     "dependencies": {
-        "@matter/general": "0.16.0-alpha.0-20250812-285b75d83",
-        "@matter/model": "0.16.0-alpha.0-20250812-285b75d83",
-        "@matter/types": "0.16.0-alpha.0-20250812-285b75d83",
-        "@matter/protocol": "0.16.0-alpha.0-20250812-285b75d83"
+        "@matter/general": "0.16.0-alpha.0-20250815-ac9fd6eb0",
+        "@matter/model": "0.16.0-alpha.0-20250815-ac9fd6eb0",
+        "@matter/types": "0.16.0-alpha.0-20250815-ac9fd6eb0",
+        "@matter/protocol": "0.16.0-alpha.0-20250815-ac9fd6eb0"
     },
     "devDependencies": {
-        "@matter/tools": "0.16.0-alpha.0-20250812-285b75d83",
-        "@matter/testing": "0.16.0-alpha.0-20250812-285b75d83"
+        "@matter/tools": "0.16.0-alpha.0-20250815-ac9fd6eb0",
+        "@matter/testing": "0.16.0-alpha.0-20250815-ac9fd6eb0"
     },
     "files": [
         "dist/**/*",

package/src/behavior/state/validation/assertions.ts

@@ -4,7 +4,7 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 
-import { isObject } from "#general";
+import { Bytes, isObject } from "#general";
 import { SchemaErrorPath } from "#model";
 import { DatatypeError, Val } from "#protocol";
 
@@ -43,15 +43,15 @@ export function assertString(value: Val, path: SchemaErrorPath): asserts value i
     throw new DatatypeError(path, "a string", value);
 }
 
-export function assertBytes(value: Val, path: SchemaErrorPath): asserts value is Uint8Array {
-    if (value instanceof Uint8Array) {
+export function assertBytes(value: Val, path: SchemaErrorPath): asserts value is BufferSource {
+    if (Bytes.isBytes(value)) {
         return;
     }
     throw new DatatypeError(path, "a byte array", value);
 }
 
-export function assertSequence(value: Val, path: SchemaErrorPath): asserts value is string | Uint8Array {
-    if (typeof value === "string" || value instanceof Uint8Array) {
+export function assertSequence(value: Val, path: SchemaErrorPath): asserts value is string | BufferSource {
+    if (typeof value === "string" || Bytes.isBytes(value)) {
         return;
     }
     throw new DatatypeError(path, "a string or byte array", value);

package/src/behavior/state/validation/constraint.ts

@@ -97,11 +97,12 @@ function create(
         case Metatype.string: {
             const validateLength: ValueSupervisor.Validate = (value: Val, _session, location) => {
                 assertSequence(value, location);
-                if (!constraint.test(value.length, nameResolverFactory(location))) {
+                const length = typeof value === "string" ? value.length : value.byteLength;
+                if (!constraint.test(length, nameResolverFactory(location))) {
                     throw new ConstraintError(
                         schema,
                         location,
-                        `String length of ${value.length} is not within bounds defined by constraint`,
+                        `String length of ${length} is not within bounds defined by constraint`,
                     );
                 }
             };
@@ -129,11 +130,12 @@ function create(
         case Metatype.bytes:
             return (value: Val, _session, location) => {
                 assertSequence(value, location);
-                if (!constraint.test(value.length, nameResolverFactory(location))) {
+                const length = typeof value === "string" ? value.length : value.byteLength;
+                if (!constraint.test(length, nameResolverFactory(location))) {
                     throw new ConstraintError(
                         schema,
                         location,
-                        `Byte length of ${value.length} is not within bounds defined by constraint`,
+                        `Byte length of ${length} is not within bounds defined by constraint`,
                     );
                 }
             };

package/src/behavior/system/commissioning/CommissioningServer.ts

@@ -374,7 +374,7 @@ export namespace CommissioningServer {
         passcode = -1;
         discriminator = -1;
         flowType = CommissioningFlowType.Standard;
-        additionalBleAdvertisementData?: Uint8Array = undefined;
+        additionalBleAdvertisementData?: BufferSource = undefined;
         pairingCodes = {} as PairingCodes;
         mdns?: MdnsAdvertiser.Options;
         ble?: BleAdvertiser.Options;

package/src/behaviors/access-control/AccessControlServer.ts

@@ -6,7 +6,7 @@
 
 import { ActionContext } from "#behavior/context/ActionContext.js";
 import { AccessControl as AccessControlTypes } from "#clusters/access-control";
-import { deepCopy, InternalError, Logger, MaybePromise } from "#general";
+import { Bytes, deepCopy, InternalError, Logger, MaybePromise } from "#general";
 import { NodeLifecycle } from "#node/NodeLifecycle.js";
 import {
     AccessControl,
@@ -401,7 +401,12 @@ export class AccessControlServer extends AccessControlBehavior.with("Extension")
      */
     protected extensionEntryValidator(extension: AccessControlTypes.AccessControlExtension) {
         const { data } = extension;
-        if (data.length < 2 || data[0] !== TlvType.List || data[data.length - 1] !== TlvType.EndOfContainer) {
+        const extensionBytes = Bytes.of(data);
+        if (
+            extensionBytes.length < 2 ||
+            extensionBytes[0] !== TlvType.List ||
+            extensionBytes[extensionBytes.length - 1] !== TlvType.EndOfContainer
+        ) {
             // Easier to check that way that it is an Listen without any tags in general
             throw new StatusResponseError("Extension must be a valid TLV", StatusCode.ConstraintError);
         }

package/src/behaviors/administrator-commissioning/AdministratorCommissioningServer.ts

@@ -74,13 +74,13 @@ export class AdministratorCommissioningServer extends AdministratorCommissioning
         commissioningTimeout,
     }: AdministratorCommissioning.OpenCommissioningWindowRequest) {
         // We monkey patched the Tlv definition above, so take care about correct error handling
-        if (pakePasscodeVerifier.length !== PAKE_PASSCODE_VERIFIER_LENGTH) {
+        if (pakePasscodeVerifier.byteLength !== PAKE_PASSCODE_VERIFIER_LENGTH) {
             throw new AdministratorCommissioning.PakeParameterError("PAKE passcode verifier length is invalid");
         }
         if (iterations < 1000 || iterations > 100_000) {
             throw new AdministratorCommissioning.PakeParameterError("PAKE iterations invalid");
         }
-        if (salt.length < 16 || salt.length > 32) {
+        if (salt.byteLength < 16 || salt.byteLength > 32) {
             throw new AdministratorCommissioning.PakeParameterError("PAKE salt has invalid length.");
         }
 

package/src/behaviors/general-diagnostics/GeneralDiagnosticsServer.ts

@@ -53,7 +53,8 @@ export class GeneralDiagnosticsServer extends Base {
         if (this.state.testEventTriggersEnabled === undefined) {
             this.state.testEventTriggersEnabled = false;
         } else if (this.state.testEventTriggersEnabled) {
-            if (this.state.deviceTestEnableKey.every(byte => byte === 0)) {
+            const enableKey = Bytes.of(this.state.deviceTestEnableKey);
+            if (enableKey.every(byte => byte === 0)) {
                 throw new ImplementationError("Test event triggers are enabled but no deviceTestEnableKey is set.");
             }
             logger.warn("Test event triggers are enabled. Make sure to disable them in production.");
@@ -80,12 +81,14 @@ export class GeneralDiagnosticsServer extends Base {
         }
     }
 
-    #validateTestEnabledKey(enableKey: Uint8Array) {
-        if (enableKey.every(byte => byte === 0)) {
+    #validateTestEnabledKey(enableKey: Bytes) {
+        const keyData = Bytes.of(enableKey);
+        if (keyData.every(byte => byte === 0)) {
             throw new StatusResponseError("Invalid test enable key, all zeros", StatusCode.ConstraintError);
         }
-        enableKey.forEach((byte, index) => {
-            if (byte !== this.state.deviceTestEnableKey[index]) {
+        const expectedKeyData = Bytes.of(this.state.deviceTestEnableKey);
+        keyData.forEach((byte, index) => {
+            if (byte !== expectedKeyData[index]) {
                 throw new StatusResponseError("Invalid test enable key", StatusCode.ConstraintError);
             }
         });
@@ -154,7 +157,7 @@ export class GeneralDiagnosticsServer extends Base {
                     },
                 },
             ],
-        }).length;
+        }).byteLength;
 
         const exchange = this.context.exchange;
         if (exchange === undefined) {
@@ -390,7 +393,7 @@ export namespace GeneralDiagnosticsServer {
         totalOperationalHoursCounter: number = 0;
 
         /** The TestEnableKey set for this device for the test commands. Default means "not enabled"." */
-        deviceTestEnableKey = new Uint8Array(16).fill(0);
+        deviceTestEnableKey: Bytes = new Uint8Array(16).fill(0);
 
         [Val.properties](endpoint: Endpoint, _session: ValueSupervisor.Session) {
             return {

package/src/behaviors/groups/GroupsServer.ts

@@ -75,8 +75,12 @@ export class GroupsServer extends GroupsBase {
         return rootEndpoint;
     }
 
-    #actOnGroupKeyManagement(act: (groupKeyManagement: GroupKeyManagementServer) => unknown) {
-        return this.#rootEndpoint().act(agent => act(agent.get(GroupKeyManagementServer)));
+    async #actOnGroupKeyManagement<T>(act: (groupKeyManagement: GroupKeyManagementServer) => T): Promise<T> {
+        const agent = this.context.agentFor(this.#rootEndpoint());
+        const gkm = agent.get(GroupKeyManagementServer);
+        await agent.context.transaction.addResources(gkm);
+        await agent.context.transaction.begin();
+        return act(gkm);
     }
 
     override async addGroup({ groupId, groupName }: Groups.AddGroupRequest): Promise<Groups.AddGroupResponse> {

package/src/behaviors/on-off/OnOffServer.ts

@@ -71,7 +71,7 @@ export class OnOffBaseServer extends OnOffLogicBase {
                     this.delayedOffTimer.start();
                 }
             }
-            this.state.onTime = this.state.offWaitTime = 0;
+            this.state.onTime = 0;
         }
     }
 
@@ -168,7 +168,7 @@ export class OnOffBaseServer extends OnOffLogicBase {
     protected get delayedOffTimer() {
         let timer = this.internal.delayedOffTimer;
         if (timer === undefined) {
-            timer = this.internal.delayedOffTimer = Time.getTimer(
+            timer = this.internal.delayedOffTimer = Time.getPeriodicTimer(
                 "Delayed off",
                 100,
                 this.callback(this.#delayedOffTick, { lock: true }),

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

@@ -94,7 +94,7 @@ export class OperationalCredentialsServer extends OperationalCredentialsBehavior
     }
 
     override async attestationRequest({ attestationNonce }: OperationalCredentials.AttestationRequest) {
-        if (attestationNonce.length !== 32) {
+        if (attestationNonce.byteLength !== 32) {
             throw new StatusResponseError("Invalid attestation nonce length", StatusCode.InvalidCommand);
         }
 
@@ -115,7 +115,7 @@ export class OperationalCredentialsServer extends OperationalCredentialsBehavior
     }
 
     override async csrRequest({ csrNonce, isForUpdateNoc }: OperationalCredentials.CsrRequest) {
-        if (csrNonce.length !== 32) {
+        if (csrNonce.byteLength !== 32) {
             throw new StatusResponseError("Invalid csr nonce length", StatusCode.InvalidCommand);
         }
 

package/src/behaviors/rvc-run-mode/RvcRunModeServer.ts

@@ -36,13 +36,6 @@ export class RvcRunModeServer extends RvcRunModeBehavior {
         ) {
             throw new ImplementationError("Provided supportedModes need to include at least one Cleaning mode tag");
         }
-        if (
-            !this.state.supportedModes.some(({ modeTags }) =>
-                modeTags.some(({ value }) => value === RvcRunMode.ModeTag.Cleaning),
-            )
-        ) {
-            throw new ImplementationError("Provided supportedModes need to include at least one Cleaning mode tag");
-        }
         if (
             this.state.supportedModes.some(({ modeTags }) => {
                 let exclusiveModeCounter = 0;

package/src/node/server/InteractionServer.ts

@@ -714,7 +714,7 @@ export class InteractionServer implements ProtocolHandler, InteractionRecipient
             moreChunkedMessages: invokeRequests.length > 1, // Assume for now we have multiple responses when having multiple invokes
         };
         const emptyInvokeResponseBytes = TlvInvokeResponseForSend.encode(invokeResponseMessage);
-        let messageSize = emptyInvokeResponseBytes.length;
+        let messageSize = emptyInvokeResponseBytes.byteLength;
         let invokeResultsProcessed = 0;
 
         // To lower potential latency when we would process all invoke messages and just send responses at the end we
@@ -766,7 +766,7 @@ export class InteractionServer implements ProtocolHandler, InteractionRecipient
                         },
                     );
                     invokeResponseMessage.invokeResponses = [];
-                    messageSize = emptyInvokeResponseBytes.length;
+                    messageSize = emptyInvokeResponseBytes.byteLength;
                 }
                 if (!lastMessageProcessed) {
                     invokeResultsProcessed--; // Correct counter again because we recall the method