@matter/protocol 0.16.0-alpha.0-20251016-b56cf5683 → 0.16.0-alpha.0-20251020-3f6e46245

package/dist/esm/action/client/ClientInteraction.js

@@ -3,14 +3,28 @@
  * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
-import { BasicSet, Environmental, ImplementationError, Seconds } from "#general";
+import { resolvePathForSpecifier } from "#action/index.js";
+import { Invoke } from "#action/request/Invoke.js";
+import {
+  BasicSet,
+  Diagnostic,
+  Duration,
+  Environmental,
+  ImplementationError,
+  isObject,
+  Logger,
+  Seconds
+} from "#general";
 import { InteractionClientMessenger, MessageType } from "#interaction/InteractionMessenger.js";
 import { InteractionQueue } from "#peer/InteractionQueue.js";
 import { ExchangeProvider } from "#protocol/ExchangeProvider.js";
-import { TlvSubscribeResponse } from "#types";
+import { Status, TlvNoResponse, TlvSubscribeResponse } from "#types";
 import { ClientSubscriptions } from "./ClientSubscriptions.js";
 import { InputChunk } from "./InputChunk.js";
+const logger = Logger.get("ClientInteraction");
 const DEFAULT_MIN_INTERVAL_FLOOR = Seconds(1);
+const DEFAULT_TIMED_REQUEST_TIMEOUT = Seconds(10);
+const DEFAULT_MINIMUM_RESPONSE_TIMEOUT_WITH_FAILSAFE = Seconds(30);
 class ClientInteraction {
   #exchanges;
   #subscriptions;
@@ -44,34 +58,71 @@ class ClientInteraction {
     return instance;
   }
   async *read(request, _session) {
+    const readPathsCount = (request.attributeRequests?.length ?? 0) + (request.eventRequests?.length ?? 0);
+    if (readPathsCount > 9) {
+      logger.debug(
+        "Read interactions with more then 9 paths might be not allowed by the device. Consider splitting then into several read requests."
+      );
+    }
+    this.#begin(request);
+    let messenger;
     try {
-      this.#begin(request);
-      const messenger = await InteractionClientMessenger.create(this.#exchanges);
+      messenger = await InteractionClientMessenger.create(this.#exchanges);
+      logger.debug("Read \xBB", messenger.exchange.via, request);
       await messenger.sendReadRequest(request);
+      let attributeReportCount = 0;
+      let eventReportCount = 0;
       for await (const report of messenger.readDataReports()) {
+        attributeReportCount += report.attributeReports?.length ?? 0;
+        eventReportCount += report.eventReports?.length ?? 0;
         yield InputChunk(report);
       }
+      logger.debug(
+        "Read \xAB",
+        messenger.exchange.via,
+        Diagnostic.weak(
+          attributeReportCount + eventReportCount === 0 ? "(empty)" : Diagnostic.dict({ attributes: attributeReportCount, events: eventReportCount })
+        )
+      );
     } finally {
+      await messenger?.close();
       this.#end(request);
     }
   }
+  /**
+   * Write chosen attributes remotely to the node.
+   * The returned attribute write status information is returned. No error is thrown for individual attribute write
+   * failures.
+   */
   async write(request, _session) {
+    this.#begin(request);
     let messenger;
     try {
-      this.#begin(request);
       messenger = await InteractionClientMessenger.create(this.#exchanges);
+      if (request.timedRequest) {
+        await messenger.sendTimedRequest(request.timeout ?? DEFAULT_TIMED_REQUEST_TIMEOUT);
+      }
+      logger.info("Write \xBB", messenger.exchange.via, request);
       const response = await messenger.sendWriteCommand(request);
       if (request.suppressResponse) {
         return void 0;
       }
       if (!response || !response.writeResponses?.length) {
-        return new Array();
-      } else {
-        return response.writeResponses.map(
-          ({
-            path: { nodeId, endpointId, clusterId, attributeId, listIndex },
-            status: { status, clusterStatus }
-          }) => ({
+        return [];
+      }
+      let successCount = 0;
+      let failureCount = 0;
+      const result = response.writeResponses.map(
+        ({
+          path: { nodeId, endpointId, clusterId, attributeId, listIndex },
+          status: { status, clusterStatus }
+        }) => {
+          if (status === Status.Success) {
+            successCount++;
+          } else {
+            failureCount++;
+          }
+          return {
             kind: "attr-status",
             path: {
               nodeId,
@@ -82,20 +133,41 @@ class ClientInteraction {
             },
             status,
             clusterStatus
-          })
-        );
-      }
+          };
+        }
+      );
+      logger.info(
+        "Write \xAB",
+        messenger.exchange.via,
+        Diagnostic.weak(
+          successCount + failureCount === 0 ? "(empty)" : Diagnostic.dict({ success: successCount, failure: failureCount })
+        )
+      );
+      return result;
     } finally {
       await messenger?.close();
       this.#end(request);
     }
   }
   async *invoke(request, _session) {
+    this.#begin(request);
     let messenger;
     try {
-      this.#begin(request);
       messenger = await InteractionClientMessenger.create(this.#exchanges);
-      const result = await messenger.sendInvokeCommand(request);
+      if (request.timedRequest) {
+        await messenger.sendTimedRequest(request.timeout ?? DEFAULT_TIMED_REQUEST_TIMEOUT);
+      }
+      logger.info(
+        "Invoke \xBB",
+        messenger.exchange.via,
+        Diagnostic.asFlags({ suppressResponse: request.suppressResponse, timed: request.timedRequest }),
+        request
+      );
+      const { expectedProcessingTime, useExtendedFailSafeMessageResponseTimeout } = request;
+      const result = await messenger.sendInvokeCommand(
+        request,
+        expectedProcessingTime ?? (useExtendedFailSafeMessageResponseTimeout ? DEFAULT_MINIMUM_RESPONSE_TIMEOUT_WITH_FAILSAFE : void 0)
+      );
       if (!request.suppressResponse) {
         if (result && result.invokeResponses?.length) {
           const chunk = result.invokeResponses.map((response) => {
@@ -105,6 +177,25 @@ class ClientInteraction {
                 commandRef,
                 commandFields
               } = response.command;
+              const cmd = request.commands.get(commandRef);
+              if (!cmd) {
+                throw new ImplementationError(
+                  `No response schema found for commandRef ${commandRef} (endpoint ${endpointId}, cluster ${clusterId}, command ${commandId})`
+                );
+              }
+              const responseSchema = Invoke.commandOf(cmd).responseSchema;
+              if (commandFields === void 0 && responseSchema !== TlvNoResponse) {
+                throw new ImplementationError(
+                  `No command fields found for commandRef ${commandRef} (endpoint ${endpointId}, cluster ${clusterId}, command ${commandId})`
+                );
+              }
+              const data = commandFields === void 0 ? void 0 : responseSchema.decodeTlv(commandFields);
+              logger.info(
+                "Invoke \xAB",
+                messenger.exchange.via,
+                Diagnostic.strong(resolvePathForSpecifier(cmd)),
+                isObject(data) ? Diagnostic.dict(data) : Diagnostic.weak("(no payload)")
+              );
               const res = {
                 kind: "cmd-response",
                 path: {
@@ -113,8 +204,7 @@ class ClientInteraction {
                   commandId
                 },
                 commandRef,
-                data: commandFields
-                // TODO add decoding
+                data
               };
               return res;
             } else if (response.status !== void 0) {
@@ -150,10 +240,32 @@ class ClientInteraction {
     }
   }
   async subscribe(request, _session) {
+    const subscriptionPathsCount = (request.attributeRequests?.length ?? 0) + (request.eventRequests?.length ?? 0);
+    if (subscriptionPathsCount > 3) {
+      logger.debug("Subscribe interactions with more then 3 paths might be not allowed by the device.");
+    }
+    if (!request.keepSubscriptions) {
+      for (const subscription of this.#subscriptions) {
+        logger.debug(
+          `Removing subscription with ID ${subscription.subscriptionId} because new subscription replaces it`
+        );
+        subscription.close();
+      }
+    }
+    this.#begin(request);
     let messenger;
     try {
-      this.#begin(request);
       messenger = await InteractionClientMessenger.create(this.#exchanges);
+      logger.info(
+        "Subscribe \xBB",
+        messenger.exchange.via,
+        Diagnostic.asFlags({ keepSubscriptions: request.keepSubscriptions }),
+        Diagnostic.dict({
+          min: Duration.format(request.minIntervalFloor),
+          max: Duration.format(request.maxIntervalCeiling)
+        }),
+        request
+      );
       await messenger.sendSubscribeRequest({
         minIntervalFloorSeconds: Seconds.of(DEFAULT_MIN_INTERVAL_FLOOR),
         maxIntervalCeilingSeconds: Seconds.of(DEFAULT_MIN_INTERVAL_FLOOR),
@@ -163,6 +275,14 @@ class ClientInteraction {
       await this.#handleSubscriptionResponse(request, readChunks(messenger));
       const responseMessage = await messenger.nextMessage(MessageType.SubscribeResponse);
       const response = TlvSubscribeResponse.decode(responseMessage.payload);
+      logger.info(
+        "Subscription successful \xAB",
+        messenger.exchange.via,
+        Diagnostic.dict({
+          subId: response.subscriptionId,
+          interval: Duration.format(Seconds(response.maxInterval))
+        })
+      );
       return this.#subscriptions.add(request, response);
     } finally {
       await messenger?.close();

package/dist/esm/action/client/ClientInteraction.js.map

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

package/dist/esm/action/request/Invoke.d.ts

@@ -3,37 +3,65 @@
  * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
+import { Duration } from "#general";
 import { ClusterType, CommandData, InvokeRequest, TlvSchema, TypeFromSchema } from "#types";
 import { Specifier } from "./Specifier.js";
+export interface InvokeCommandData extends CommandData {
+    timed?: boolean;
+}
 export interface Invoke extends InvokeRequest {
     /** Timeout only relevant for Client Interactions */
-    timeout?: number;
+    timeout?: Duration;
+    expectedProcessingTime?: Duration;
+    useExtendedFailSafeMessageResponseTimeout?: boolean;
+}
+export interface ClientInvoke extends Invoke {
+    commands: Map<number | undefined, Invoke.CommandRequest<any>>;
 }
 /**
  * Request invocation of one or more commands.
  */
-export declare function Invoke(options: Invoke.Definition): Invoke;
+export declare function Invoke(options: Invoke.Definition): ClientInvoke;
 /**
  * Request invocation multiple commands with defined options
  */
-export declare function Invoke(options: Invoke.Definition, ...commands: CommandData[]): Invoke;
+export declare function Invoke(options: Invoke.Definition, ...commands: Invoke.CommandRequest<any>[]): ClientInvoke;
 /**
  * Request invocation multiple commands as list of Commands with default options.
  */
-export declare function Invoke(...commands: CommandData[]): Invoke;
+export declare function Invoke(...commands: Invoke.CommandRequest<any>[]): ClientInvoke;
 export declare namespace Invoke {
     interface Definition {
-        commands: CommandData[];
+        /** List of commands to invoke */
+        commands: Invoke.CommandRequest<any>[];
+        /** Tell the server to not send a response */
         suppressResponse?: boolean;
+        /** Whether this is sent as a timed request, if no timeout is specified a default is used */
         timed?: boolean;
+        /** Timeout when sent as a timed request, if timed flag is not set it will be set automatically */
+        timeout?: Duration;
+        /** Interaction model revision to use, if not specified a default is used */
         interactionModelRevision?: number;
+        /** Processing time of the command of the server assumed for this invoke. If not set a default is used */
+        expectedProcessingTime?: Duration;
+        /** Whether to use extended timeout for fail-safe messages.  Overwrites the expectedProcessingTime if both are set */
+        useExtendedFailSafeMessageResponseTimeout?: boolean;
+        /** Whether to skip validation of command fields against schema */
+        skipValidation?: boolean;
     }
-    function Command<const C extends ClusterType>(request: Invoke.CommandRequest<C>): CommandData;
-    type CommandRequest<C extends Specifier.Cluster = Specifier.Cluster, CMD extends Specifier.Command<Specifier.ClusterFor<C>> = Specifier.Command<Specifier.ClusterFor<C>>> = {
-        endpoint?: Specifier.Endpoint;
+    function Command<const C extends ClusterType>(request: Invoke.CommandRequest<C>, skipValidation?: boolean): InvokeCommandData;
+    type CommandRequest<C extends Specifier.Cluster = Specifier.Cluster, CMD extends Specifier.Command<Specifier.ClusterFor<C>> = Specifier.Command<Specifier.ClusterFor<C>>> = ConcreteCommandRequest<C, CMD> | WildcardCommandRequest<C, CMD>;
+    type ConcreteCommandRequest<C extends Specifier.Cluster = Specifier.Cluster, CMD extends Specifier.Command<Specifier.ClusterFor<C>> = Specifier.Command<Specifier.ClusterFor<C>>> = WildcardCommandRequest<C, CMD> & {
+        endpoint: Specifier.Endpoint;
+    };
+    function ConcreteCommandRequest<const C extends ClusterType>(data: Invoke.ConcreteCommandRequest<C>): Invoke.ConcreteCommandRequest<any>;
+    type WildcardCommandRequest<C extends Specifier.Cluster = Specifier.Cluster, CMD extends Specifier.Command<Specifier.ClusterFor<C>> = Specifier.Command<Specifier.ClusterFor<C>>> = {
         cluster: C;
         command: CMD;
+        commandName?: string;
+        commandRef?: number;
     } & Fields<Specifier.CommandFor<Specifier.ClusterFor<C>, CMD>["requestSchema"]>;
+    function WildcardCommandRequest<const C extends ClusterType>(data: Invoke.WildcardCommandRequest<C>): Invoke.WildcardCommandRequest<any>;
     function commandOf<const R extends CommandRequest>(request: R): ClusterType.Command;
     type Fields<S extends TlvSchema<any>> = S extends TlvSchema<void> ? {} : S extends TlvSchema<null> ? {
         fields?: TypeFromSchema<S>;

package/dist/esm/action/request/Invoke.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Invoke.d.ts","sourceRoot":"","sources":["../../../../src/action/request/Invoke.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,aAAa,EAAE,SAAS,EAAa,cAAc,EAAE,MAAM,QAAQ,CAAC;AAEvG,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,MAAM,WAAW,MAAO,SAAQ,aAAa;IACzC,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC;AAE3D;;GAEG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,UAAU,EAAE,GAAG,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;AAEvF;;GAEG;AACH,wBAAgB,MAAM,CAAC,GAAG,QAAQ,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;AAwC3D,yBAAiB,MAAM,CAAC;IACpB,UAAiB,UAAU;QACvB,QAAQ,EAAE,WAAW,EAAE,CAAC;QACxB,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,wBAAwB,CAAC,EAAE,MAAM,CAAC;KACrC;IAED,SAAgB,OAAO,CAAC,KAAK,CAAC,CAAC,SAAS,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,GAAG,WAAW,CAuBnG;IAED,KAAY,cAAc,CACtB,CAAC,SAAS,SAAS,CAAC,OAAO,GAAG,SAAS,CAAC,OAAO,EAC/C,GAAG,SAAS,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IACnG;QACA,QAAQ,CAAC,EAAE,SAAS,CAAC,QAAQ,CAAC;QAC9B,OAAO,EAAE,CAAC,CAAC;QACX,OAAO,EAAE,GAAG,CAAC;KAChB,GAAG,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC;IAEhF,SAAgB,SAAS,CAAC,KAAK,CAAC,CAAC,SAAS,cAAc,EAAE,OAAO,EAAE,CAAC,GAAG,WAAW,CAAC,OAAO,CAazF;IAED,KAAY,MAAM,CAAC,CAAC,SAAS,SAAS,CAAC,GAAG,CAAC,IACvC,CAAC,SAAS,SAAS,CAAC,IAAI,CAAC,GACnB,EAAE,GACF,CAAC,SAAS,SAAS,CAAC,IAAI,CAAC,GACvB;QAAE,MAAM,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,CAAA;KAAE,GAC9B;QAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAA;KAAE,CAAC;CAC7C"}
+{"version":3,"file":"Invoke.d.ts","sourceRoot":"","sources":["../../../../src/action/request/Invoke.ts"],"names":[],"mappings":"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"}

package/dist/esm/action/request/Invoke.js

@@ -3,9 +3,11 @@
  * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
+import { Diagnostic, isObject } from "#general";
 import { FALLBACK_INTERACTIONMODEL_REVISION } from "#session/Session.js";
+import { FabricIndex, ObjectSchema } from "#types";
 import { MalformedRequestError } from "./MalformedRequestError.js";
-import { Specifier } from "./Specifier.js";
+import { resolvePathForSpecifier, Specifier } from "./Specifier.js";
 function Invoke(optionsOrData, ...commands) {
   if (optionsOrData === void 0) {
     throw new MalformedRequestError(`Invocation requires at least one command`);
@@ -13,44 +15,93 @@ function Invoke(optionsOrData, ...commands) {
   let options;
   if ("commands" in optionsOrData) {
     options = optionsOrData;
+    commands = [...optionsOrData.commands, ...commands];
   } else {
     commands = [optionsOrData, ...commands];
     options = {};
   }
   const {
-    commands: invokeRequests = [],
     interactionModelRevision = FALLBACK_INTERACTIONMODEL_REVISION,
     suppressResponse = false,
-    timed: timedRequest = false
+    timeout,
+    expectedProcessingTime,
+    useExtendedFailSafeMessageResponseTimeout = false,
+    skipValidation = false
   } = options;
-  if (commands.length) {
-    for (const entry of commands) {
-      invokeRequests.push(entry);
-    }
-  }
-  if (!invokeRequests?.length) {
+  let timedRequest = !!options.timed || !!timeout;
+  if (!commands?.length) {
     throw new MalformedRequestError(`Invocation requires at least one command`);
   }
+  if (commands.length > 1) {
+    const commandRefs = /* @__PURE__ */ new Set();
+    for (const { commandRef } of commands) {
+      if (commandRef === void 0) {
+        throw new MalformedRequestError(`CommandRef required when invoking multiple commands`);
+      }
+      if (commandRefs.has(commandRef)) {
+        throw new MalformedRequestError(`Duplicate commandRef ${commandRef} in multiple command invoke`);
+      }
+      commandRefs.add(commandRef);
+    }
+  }
+  const commandMap = /* @__PURE__ */ new Map();
+  const invokeRequests = commands.map((cmd) => {
+    const cmdData = Invoke.Command(cmd, skipValidation);
+    timedRequest ||= !!cmdData.timed;
+    commandMap.set(cmdData.commandRef, cmd);
+    return cmdData;
+  });
   return {
+    timedRequest,
+    timeout,
     invokeRequests,
     interactionModelRevision,
     suppressResponse,
-    timedRequest
+    expectedProcessingTime,
+    useExtendedFailSafeMessageResponseTimeout,
+    // Additional meta-data for client side processing
+    commands: commandMap,
+    [Diagnostic.value]: () => Diagnostic.list(
+      commands.map((cmd) => {
+        const { commandRef } = cmd;
+        const fields = "fields" in cmd ? cmd.fields : void 0;
+        return [
+          Diagnostic.strong(resolvePathForSpecifier(cmd)),
+          "with",
+          isObject(fields) ? Diagnostic.dict(fields) : "(no payload)",
+          commandRef !== void 0 ? `(ref ${commandRef})` : ""
+        ];
+      })
+    )
   };
 }
 ((Invoke2) => {
-  function Command(request) {
+  function Command(request, skipValidation = false) {
     const command = Invoke2.commandOf(request);
-    let commandFields;
-    if ("fields" in request) {
-      commandFields = command.requestSchema.encodeTlv(request.fields, { forWriteInteraction: true });
+    const { requestSchema, requestId, timed } = command;
+    const { commandRef } = request;
+    let fields = "fields" in request ? request.fields : void 0;
+    if (requestSchema instanceof ObjectSchema) {
+      if (fields === void 0) {
+        fields = {};
+      }
+      if (requestSchema.isFabricScoped && fields.fabricIndex === void 0) {
+        fields.fabricIndex = FabricIndex.NO_FABRIC;
+      }
+    }
+    if (!skipValidation) {
+      requestSchema.validate(fields);
     }
+    const commandFields = requestSchema.encodeTlv(fields);
     const result = {
       commandPath: {
+        // Endpoint id is added below if not wildcard
         clusterId: Specifier.clusterFor(request.cluster).id,
-        commandId: command.requestId
+        commandId: requestId
       },
-      commandFields
+      commandFields,
+      timed: timed ?? false,
+      commandRef
     };
     const endpointId = Specifier.endpointIdOf(request);
     if (endpointId !== void 0) {
@@ -59,6 +110,20 @@ function Invoke(optionsOrData, ...commands) {
     return result;
   }
   Invoke2.Command = Command;
+  function ConcreteCommandRequest(data) {
+    if (data.endpoint === void 0) {
+      throw new MalformedRequestError(`ConcreteCommandRequest requires an endpoint`);
+    }
+    return data;
+  }
+  Invoke2.ConcreteCommandRequest = ConcreteCommandRequest;
+  function WildcardCommandRequest(data) {
+    if ("endpoint" in data && data.endpoint !== void 0) {
+      throw new MalformedRequestError(`ConcreteCommandRequest must not have an endpoint`);
+    }
+    return data;
+  }
+  Invoke2.WildcardCommandRequest = WildcardCommandRequest;
   function commandOf(request) {
     if (typeof request.command === "string") {
       const cluster = Specifier.clusterFor(request.cluster);

package/dist/esm/action/request/Invoke.js.map

@@ -1,6 +1,6 @@
 {
   "version": 3,
   "sources": ["../../../../src/action/request/Invoke.ts"],
-  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAMA,SAAS,0CAA0C;AAEnD,SAAS,6BAA6B;AACtC,SAAS,iBAAiB;AAsBnB,SAAS,OAAO,kBAAmD,UAAiC;AACvG,MAAI,kBAAkB,QAAW;AAC7B,UAAM,IAAI,sBAAsB,0CAA0C;AAAA,EAC9E;AAEA,MAAI;AACJ,MAAI,cAAc,eAAe;AAC7B,cAAU;AAAA,EACd,OAAO;AACH,eAAW,CAAC,eAAe,GAAG,QAAQ;AACtC,cAAU,CAAC;AAAA,EACf;AAEA,QAAM;AAAA,IACF,UAAU,iBAAiB,CAAC;AAAA,IAC5B,2BAA2B;AAAA,IAC3B,mBAAmB;AAAA,IACnB,OAAO,eAAe;AAAA,EAC1B,IAAI;AAEJ,MAAI,SAAS,QAAQ;AACjB,eAAW,SAAS,UAAU;AAC1B,qBAAe,KAAK,KAAK;AAAA,IAC7B;AAAA,EACJ;AAEA,MAAI,CAAC,gBAAgB,QAAQ;AACzB,UAAM,IAAI,sBAAsB,0CAA0C;AAAA,EAC9E;AAEA,SAAO;AAAA,IACH;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,EACJ;AACJ;AAAA,CAEO,CAAUA,YAAV;AAQI,WAAS,QAAqC,SAAgD;AACjG,UAAM,UAAUA,QAAO,UAAU,OAAO;AAExC,QAAI;AAEJ,QAAI,YAAY,SAAS;AACrB,sBAAgB,QAAQ,cAAc,UAAU,QAAQ,QAAQ,EAAE,qBAAqB,KAAK,CAAC;AAAA,IACjG;AAEA,UAAM,SAAsB;AAAA,MACxB,aAAa;AAAA,QACT,WAAW,UAAU,WAAW,QAAQ,OAAO,EAAE;AAAA,QACjD,WAAW,QAAQ;AAAA,MACvB;AAAA,MACA;AAAA,IACJ;AAEA,UAAM,aAAa,UAAU,aAAa,OAAO;AACjD,QAAI,eAAe,QAAW;AAC1B,aAAO,YAAY,aAAa;AAAA,IACpC;AAEA,WAAO;AAAA,EACX;AAvBO,EAAAA,QAAS;AAkCT,WAAS,UAA0C,SAAiC;AACvF,QAAI,OAAO,QAAQ,YAAY,UAAU;AACrC,YAAM,UAAU,UAAU,WAAW,QAAQ,OAAO;AACpD,UAAI,YAAY,QAAW;AACvB,cAAM,IAAI,sBAAsB,6BAA6B,QAAQ,OAAO,mBAAmB;AAAA,MACnG;AACA,YAAM,UAAU,QAAQ,SAAS,QAAQ,OAAO;AAChD,UAAI,YAAY,QAAW;AACvB,cAAM,IAAI,sBAAsB,WAAW,QAAQ,IAAI,4BAA4B,QAAQ,OAAO,EAAE;AAAA,MACxG;AACA,aAAO;AAAA,IACX;AACA,WAAO,QAAQ;AAAA,EACnB;AAbO,EAAAA,QAAS;AAAA,GA1CH;",
+  "mappings": "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",
   "names": ["Invoke"]
 }

package/dist/esm/action/request/Read.d.ts

@@ -3,7 +3,7 @@
  * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
-import type { AttributePath, ClusterType, DataVersionFilter, EventFilter, EventPath, GlobalAttributes, ReadRequest } from "#types";
+import { AttributePath, ClusterType, DataVersionFilter, EventFilter, EventPath, GlobalAttributes, ReadRequest } from "#types";
 import { Specifier } from "./Specifier.js";
 /**
  * A read request formulated using Matter protocol semantics.

package/dist/esm/action/request/Read.d.ts.map

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

package/dist/esm/action/request/Read.js

@@ -3,10 +3,10 @@
  * Copyright 2022-2025 Matter.js Authors
  * SPDX-License-Identifier: Apache-2.0
  */
-import { camelize } from "#general";
-import { FALLBACK_INTERACTIONMODEL_REVISION } from "#session/Session.js";
+import { camelize, Diagnostic } from "#general";
+import { Specification } from "#model";
 import { MalformedRequestError } from "./MalformedRequestError.js";
-import { Specifier } from "./Specifier.js";
+import { resolvePathForSpecifier, Specifier } from "./Specifier.js";
 function Read(optionsOrSelector, ...selectors) {
   if (optionsOrSelector === void 0) {
     throw new MalformedRequestError(`Read action designates no attributes or events`);
@@ -21,7 +21,15 @@ function Read(optionsOrSelector, ...selectors) {
   let { attributes: attributeRequests, versionFilters, events: eventRequests, eventFilters } = options;
   const result = {
     isFabricFiltered: options.fabricFilter ?? true,
-    interactionModelRevision: options.interactionModelRevision ?? FALLBACK_INTERACTIONMODEL_REVISION
+    interactionModelRevision: options.interactionModelRevision ?? Specification.INTERACTION_MODEL_REVISION,
+    [Diagnostic.value]: () => Diagnostic.dict({
+      attributes: attributeRequests?.length ? attributeRequests?.map((path) => resolvePathForSpecifier(path)).join(", ") : void 0,
+      events: eventRequests?.length ? eventRequests?.map((path) => resolvePathForSpecifier(path)).join(", ") : void 0,
+      dataVersionFilters: versionFilters?.length ? versionFilters.map(
+        ({ path: { endpointId, clusterId }, dataVersion }) => `${endpointId}/${clusterId}=${dataVersion}`
+      ).join(", ") : void 0,
+      eventFilters: eventFilters?.length ? eventFilters.map(({ nodeId, eventMin }) => `${nodeId}=${eventMin}`).join(", ") : void 0
+    })
   };
   for (const selector of selectors) {
     reifySelector(selector);

package/dist/esm/action/request/Read.js.map

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