@matter/protocol 0.17.0-alpha.0-20260507-059f7763b → 0.17.0-alpha.0-20260508-29ff5ae9e

package/dist/esm/peer/ControllerCommissioner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ControllerCommissioner.d.ts","sourceRoot":"","sources":["../../../src/peer/ControllerCommissioner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,oBAAoB,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,EAAwB,aAAa,EAA4B,MAAM,oBAAoB,CAAC;AACnG,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAG3C,OAAO,EACH,2BAA2B,EAC3B,kCAAkC,EAErC,MAAM,sCAAsC,CAAC;AAE9C,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAG/D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAOH,YAAY,EACZ,QAAQ,EACR,WAAW,EACX,aAAa,EAIb,YAAY,EAIZ,aAAa,EACb,YAAY,EACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,MAAM,EAAuD,MAAM,eAAe,CAAC;AAE5F,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAIjE;;GAEG;AACH,MAAM,WAAW,oBAAqB,SAAQ,OAAO,CAAC,kCAAkC,CAAC;IACrF,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IAEf,mFAAmF;IACnF,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE,aAAa,KAAK,YAAY,CAAC,IAAI,CAAC,CAAC;IAExG;;;OAGG;IACH,qBAAqB,CAAC,EAAE,YAAY,CAAC,2BAA2B,CAAC,CAAC;IAElE;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;CACxD;AAED;;GAEG;AACH,MAAM,WAAW,+BAAgC,SAAQ,oBAAoB;IACzE,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B;;;OAGG;IACH,OAAO,CAAC,EAAE,QAAQ,CAAC;IAEnB;;;OAGG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB;;;;;;;;;;;OAWG;IACH,8BAA8B,CAAC,EAAE,MAAM,OAAO,CAAC;CAClD;AAED;;;;;GAKG;AACH,MAAM,WAAW,oBAAoB;IACjC,2FAA2F;IAC3F,SAAS,EAAE,aAAa,EAAE,CAAC;IAE3B,yGAAyG;IACzG,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IAEjB,2FAA2F;IAC3F,OAAO,CAAC,EAAE,QAAQ,CAAC;IAEnB,mFAAmF;IACnF,KAAK,CAAC,EAAE,WAAW,CAAC;IAEpB;;;;;;;;OAQG;IACH,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC;CACrC;AAED,uEAAuE;AACvE,MAAM,WAAW,mBAAmB;IAChC,WAAW,EAAE,WAAW,CAAC;IACzB,aAAa,CAAC,EAAE,aAAa,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC1C,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,YAAY,CAAC;IACzB,QAAQ,EAAE,cAAc,CAAC;IACzB,SAAS,EAAE,eAAe,CAAC;IAC3B,EAAE,EAAE,oBAAoB,CAAC;IACzB,WAAW,EAAE,WAAW,CAAC;CAC5B;AAED;;GAEG;AACH,qBAAa,sBAAsB;;IAI/B,YAAY,OAAO,EAAE,6BAA6B,EAGjD;IAED,MAAM,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,WAAW,0BAW7C;IAED;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,+BAA+B,GAAG,OAAO,CAAC,WAAW,CAAC,CAsC/E;IAED;;;;;;OAMG;IACG,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAwB/E;CAoVJ"}
+{"version":3,"file":"ControllerCommissioner.d.ts","sourceRoot":"","sources":["../../../src/peer/ControllerCommissioner.ts"],"names":[],"mappings":"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"}

package/dist/esm/peer/ControllerCommissioningFlow.d.ts

@@ -4,10 +4,13 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { ClientInteraction } from "#action/client/ClientInteraction.js";
+import { Bytes } from "@matter/general";
 import { ClusterId, ClusterType, EndpointNumber, FabricIndex, NodeId, VendorId } from "@matter/types";
 import { GeneralCommissioning } from "@matter/types/clusters/general-commissioning";
 import { NetworkCommissioning } from "@matter/types/clusters/network-commissioning";
 import { CertificateAuthority } from "../certificate/CertificateAuthority.js";
+import { DeviceAttestationValidator } from "../certificate/DeviceAttestationValidator.js";
+import { DclCertificateService } from "../dcl/DclCertificateService.js";
 import { Fabric } from "../fabric/Fabric.js";
 import { CommissioningError } from "./CommissioningError.js";
 import { PeerAddress } from "./PeerAddress.js";
@@ -47,6 +50,34 @@ export type ControllerCommissioningFlowOptions = {
     };
     /** The Location of the OTA provider for this fabric set on the commissioned devices if OTA is supported */
     otaUpdateProviderLocation?: OtaProviderLocation;
+    /**
+     * Attestation validation settings. Injected by ControllerCommissioner — the only user-facing
+     * part is `onFailure` which is forwarded from CommissioningClient options.
+     */
+    attestation: {
+        /** Attestation challenge key from the PASE session, used to verify attestation and CSR signatures. */
+        challengeKey: Bytes;
+        /** DclCertificateService for PAA trust store and revocation checks. Looked up from environment. */
+        dclCertificateService?: DclCertificateService;
+        /**
+         * Controls behavior when attestation produces findings.
+         * - `false`: reject on any finding
+         * - `true`: always accept with info logging
+         * - callback: receives `AttestationFinding[]`, return `true` to proceed, `false` to reject
+         * - `undefined`: accept with warning logging (backward compatibility)
+         *
+         * The callback receives either:
+         * - A single error-level finding for hard failures (invalid chain, bad signature, revoked
+         *   certificate, untrusted PAA, DCL service unavailable). The commissioner must decide
+         *   whether to proceed despite the failure.
+         * - One or more warning/info-level findings after successful validation (e.g. provisional
+         *   CD, test CD, skipped CD signer verification, no revocation data). These are
+         *   informational and the commissioner can inspect them for detailed decisions.
+         *
+         * TODO: Make required in next breaking version and remove undefined backward-compatible accept
+         */
+        onFailure?: DeviceAttestationValidator.OnAttestationFailure;
+    };
 };
 /** Result code of a single commissioning step. */
 declare enum CommissioningStepResultCode {

package/dist/esm/peer/ControllerCommissioningFlow.d.ts.map

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

package/dist/esm/peer/Peer.d.ts

@@ -9,7 +9,7 @@ import { PeerAddress } from "#peer/PeerAddress.js";
 import type { ExchangeProvider } from "#protocol/ExchangeProvider.js";
 import type { NodeSession } from "#session/NodeSession.js";
 import { SessionParameters } from "#session/SessionParameters.js";
-import { AsyncObservable, BasicSet, ChannelType, DnssdNames, Duration, Identity, IpService, Lifetime } from "@matter/general";
+import { AsyncObservable, BasicSet, ChannelType, DnssdNames, Duration, Identity, IpChannelType, IpService, Lifetime } from "@matter/general";
 import { BasicInformation } from "@matter/types/clusters/basic-information";
 import type { NetworkProfiles } from "./NetworkProfile.js";
 import { PeerConnection } from "./PeerConnection.js";
@@ -23,8 +23,12 @@ export declare class Peer {
     #private;
     /**
      * Preferred transport for outgoing connections to this peer.
+     *
+     * Only `ChannelType.TCP` has meaning here — UDP is the default with no preference, and BLE is
+     * not used for operational connections. Setting TCP is a soft hint: the connect path still falls
+     * back to UDP if the peer does not advertise TCP server support.
      */
-    transportPreference?: ChannelType;
+    transportPreference?: ChannelType.TCP;
     constructor(descriptor: PeerDescriptor, context: Peer.Context);
     /**
      * Emits when metadata changes.
@@ -39,10 +43,7 @@ export declare class Peer {
     get physicalProperties(): PhysicalDeviceProperties | undefined;
     set physicalProperties(props: PhysicalDeviceProperties | undefined);
     get basicInformation(): Peer.BasicInformation | undefined;
-    get limits(): {
-        caseSessionsPerFabric: number;
-        subscriptionsPerFabric: number;
-    };
+    get limits(): any;
     get address(): PeerAddress;
     get descriptor(): PeerDescriptor;
     get sessions(): BasicSet<NodeSession, NodeSession>;
@@ -61,6 +62,15 @@ export declare class Peer {
      * Otherwise it is zero.
      */
     get timeOffline(): Duration;
+    /**
+     * Resolve the ordered list of transports to attempt for this peer.
+     *
+     * - `requiredTransport` is a hard constraint: only that transport.
+     * - Else effective soft preference is `preferredTransport ?? transportPreference`. When TCP
+     *   and the peer advertises TCP server support, returns `[TCP, UDP]`.
+     * - Else `undefined` (default UDP, no constraint).
+     */
+    resolveTransports(requiredTransport?: ChannelType, preferredTransport?: ChannelType): IpChannelType[] | undefined;
     /**
      * Obtain a session with the peer, establishing anew as necessary.
      */
@@ -139,9 +149,15 @@ export declare namespace Peer {
          */
         timing?: Partial<PeerTimingParameters>;
         /**
-         * Constrain the transport type for this connection.
+         * Hard transport constraint for this connection (e.g. Large Message Quality requires TCP).
+         * When omitted, transports are resolved per {@link Peer.resolveTransports}.
+         */
+        requiredTransport?: ChannelType;
+        /**
+         * Per-call soft transport preference. Overrides {@link Peer.transportPreference} for this
+         * connection only and is honored only when the peer advertises matching server capability.
          */
-        transport?: ChannelType;
+        preferredTransport?: ChannelType;
         /**
          * Per-call error handler, overrides {@link PeerConnection.Context.handleError} for this connection only.
          *

package/dist/esm/peer/Peer.d.ts.map

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

package/dist/esm/peer/PeerConnection.d.ts

@@ -78,12 +78,10 @@ export declare namespace PeerConnection {
         abort?: AbortSignal;
         network?: string;
         kicker?: Observable<[KickOrigin]>;
-        /**
-         * Constrain the transport type for this connection. When set to `ChannelType.TCP`, the
-         * connection will be established over TCP (requires peer TCP Server support and local
-         * TCP outgoing enabled). When undefined, the default transport (UDP/MRP) is used.
-         */
-        transport?: ChannelType;
+        /** See {@link Peer.ConnectOptions.requiredTransport}. */
+        requiredTransport?: ChannelType;
+        /** See {@link Peer.ConnectOptions.preferredTransport}. */
+        preferredTransport?: ChannelType;
         /**
          * Per-call overrides for timing parameters.
          *

package/dist/esm/peer/PeerConnection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PeerConnection.d.ts","sourceRoot":"","sources":["../../../src/peer/PeerConnection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAKH,KAAK,EAEL,OAAO,EACP,WAAW,EAEX,QAAQ,EAER,QAAQ,EAGR,UAAU,EAEV,eAAe,EAEf,gBAAgB,EAGnB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAIjE;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAsB,cAAc,CAChC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,cAAc,CAAC,OAAO,EAC/B,OAAO,CAAC,EAAE,cAAc,CAAC,OAAO,GACjC,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAkelC;AAED,yBAAiB,cAAc,CAAC,CAAC;IAC7B,UAAiB,OAAQ,SAAQ,QAAQ,CAAC,KAAK;QAC3C,QAAQ,EAAE,cAAc,CAAC;QACzB,SAAS,EAAE,eAAe,CAAC;QAC3B,QAAQ,EAAE,eAAe,CAAC;QAE1B;;WAEG;QACH,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QAEzF,MAAM,EAAE,oBAAoB,CAAC;QAE7B;;;;;;WAMG;QACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,QAAQ,GAAG,IAAI,CAAC;KACnD;IAED,UAAiB,OAAO;QACpB,KAAK,CAAC,EAAE,WAAW,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QAElC;;;;WAIG;QACH,SAAS,CAAC,EAAE,WAAW,CAAC;QAExB;;;;;WAKG;QACH,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;QAEvC;;WAEG;QACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,QAAQ,GAAG,IAAI,CAAC;KACnD;IAED,SAAgB,cAAc,CAC1B,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,eAAe,EAC1B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,cAAc,EACvB,QAAQ,SAA6B,EACrC,eAAe,CAAC,EAAE,gBAAgB,yCAgBrC;CACJ"}
+{"version":3,"file":"PeerConnection.d.ts","sourceRoot":"","sources":["../../../src/peer/PeerConnection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAGpE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAKH,KAAK,EAEL,OAAO,EACP,WAAW,EAEX,QAAQ,EAGR,QAAQ,EAGR,UAAU,EAEV,eAAe,EAGf,gBAAgB,EAGnB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAIjE;;;;;GAKG;AACH,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,SAAS,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAsB,cAAc,CAChC,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,cAAc,CAAC,OAAO,EAC/B,OAAO,CAAC,EAAE,cAAc,CAAC,OAAO,GACjC,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CA6flC;AAED,yBAAiB,cAAc,CAAC,CAAC;IAC7B,UAAiB,OAAQ,SAAQ,QAAQ,CAAC,KAAK;QAC3C,QAAQ,EAAE,cAAc,CAAC;QACzB,SAAS,EAAE,eAAe,CAAC;QAC3B,QAAQ,EAAE,eAAe,CAAC;QAE1B;;WAEG;QACH,UAAU,CAAC,OAAO,EAAE,eAAe,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QAEzF,MAAM,EAAE,oBAAoB,CAAC;QAE7B;;;;;;WAMG;QACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,QAAQ,GAAG,IAAI,CAAC;KACnD;IAED,UAAiB,OAAO;QACpB,KAAK,CAAC,EAAE,WAAW,CAAC;QACpB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,UAAU,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;QAElC,yDAAyD;QACzD,iBAAiB,CAAC,EAAE,WAAW,CAAC;QAEhC,0DAA0D;QAC1D,kBAAkB,CAAC,EAAE,WAAW,CAAC;QAEjC;;;;;WAKG;QACH,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;QAEvC;;WAEG;QACH,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,QAAQ,GAAG,IAAI,CAAC;KACnD;IAED,SAAgB,cAAc,CAC1B,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,eAAe,EAC1B,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,cAAc,EACvB,QAAQ,SAA6B,EACrC,eAAe,CAAC,EAAE,gBAAgB,yCAgBrC;CACJ"}

package/dist/esm/peer/PeerDescriptor.d.ts

@@ -5,9 +5,19 @@
  */
 import { DiscoveryData } from "#common/Scanner.js";
 import { SessionParameters } from "#session/SessionParameters.js";
-import { ServerAddressIp } from "@matter/general";
+import { ServerAddress, ServerAddressIp, ServerAddressTcp, ServerAddressUdp } from "@matter/general";
 import { CaseAuthenticatedTag } from "@matter/types";
 import { PeerAddress } from "./PeerAddress.js";
+/** Address persisted alongside a peer; transport type is required so storage stays schema-conformant. */
+export type OperationalAddress = ServerAddressUdp | ServerAddressTcp;
+export declare namespace OperationalAddress {
+    /**
+     * Narrow an arbitrary {@link ServerAddress} (or persisted shape lacking transport tag) to
+     * {@link OperationalAddress}. Returns `undefined` for non-IP addresses; defaults missing
+     * `type` to `"udp"` so storage written before transport tagging existed still loads.
+     */
+    function from(address: ServerAddress | ServerAddressIp | undefined): OperationalAddress | undefined;
+}
 /**
  * Operational information for a single peer.
  *
@@ -25,7 +35,7 @@ export interface PeerDescriptor {
     /**
      * A physical address the peer may be accessed at, if known.
      */
-    operationalAddress?: ServerAddressIp;
+    operationalAddress?: OperationalAddress;
     /**
      * Additional information collected while locating the peer.
      */
@@ -47,8 +57,8 @@ export declare class ObservablePeerDescriptor implements PeerDescriptor {
     #private;
     constructor({ address, operationalAddress, discoveryData, caseAuthenticatedTags }: PeerDescriptor, onChange: () => void);
     get address(): PeerAddress;
-    get operationalAddress(): ServerAddressIp | undefined;
-    set operationalAddress(value: ServerAddressIp | undefined);
+    get operationalAddress(): OperationalAddress | undefined;
+    set operationalAddress(value: OperationalAddress | undefined);
     get discoveryData(): DiscoveryData | undefined;
     set discoveryData(value: DiscoveryData | undefined);
     get sessionParameters(): SessionParameters | undefined;

package/dist/esm/peer/PeerDescriptor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PeerDescriptor.d.ts","sourceRoot":"","sources":["../../../src/peer/PeerDescriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAe,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC3B;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC;IAErB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,kBAAkB,CAAC,EAAE,eAAe,CAAC;IAErC;;OAEG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B;;OAEG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAEtC;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;CAC3D;AAED,qBAAa,wBAAyB,YAAW,cAAc;;IAQ3D,YACI,EAAE,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,qBAAqB,EAAE,EAAE,cAAc,EACrF,QAAQ,EAAE,MAAM,IAAI,EAOvB;IAED,IAAI,OAAO,gBAEV;IAED,IAAI,kBAAkB,IAIQ,eAAe,GAAG,SAAS,CAFxD;IAED,IAAI,kBAAkB,CAAC,KAAK,EAAE,eAAe,GAAG,SAAS,EAOxD;IAED,IAAI,aAAa,IAIQ,aAAa,GAAG,SAAS,CAFjD;IAED,IAAI,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,EAOjD;IAED,IAAI,iBAAiB,IAIQ,iBAAiB,GAAG,SAAS,CAFzD;IAED,IAAI,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,SAAS,EAOzD;IAED,IAAI,qBAAqB,IAIO,SAAS,GAAG,SAAS,oBAAoB,EAAE,CAF1E;IAED,IAAI,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,oBAAoB,EAAE,EAO1E;CACJ"}
+{"version":3,"file":"PeerDescriptor.d.ts","sourceRoot":"","sources":["../../../src/peer/PeerDescriptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAe,aAAa,EAAE,eAAe,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAClH,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,yGAAyG;AACzG,MAAM,MAAM,kBAAkB,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAErE,yBAAiB,kBAAkB,CAAC,CAAC;IACjC;;;;OAIG;IACH,SAAgB,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,eAAe,GAAG,SAAS,GAAG,kBAAkB,GAAG,SAAS,CASzG;CACJ;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC3B;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC;IAErB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;OAEG;IACH,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IAExC;;OAEG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;IAE9B;;OAEG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IAEtC;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,SAAS,oBAAoB,EAAE,CAAC;CAC3D;AAED,qBAAa,wBAAyB,YAAW,cAAc;;IAQ3D,YACI,EAAE,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,qBAAqB,EAAE,EAAE,cAAc,EACrF,QAAQ,EAAE,MAAM,IAAI,EAOvB;IAED,IAAI,OAAO,gBAEV;IAED,IAAI,kBAAkB,IAIQ,kBAAkB,GAAG,SAAS,CAF3D;IAED,IAAI,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,SAAS,EAO3D;IAED,IAAI,aAAa,IAIQ,aAAa,GAAG,SAAS,CAFjD;IAED,IAAI,aAAa,CAAC,KAAK,EAAE,aAAa,GAAG,SAAS,EAOjD;IAED,IAAI,iBAAiB,IAIQ,iBAAiB,GAAG,SAAS,CAFzD;IAED,IAAI,iBAAiB,CAAC,KAAK,EAAE,iBAAiB,GAAG,SAAS,EAOzD;IAED,IAAI,qBAAqB,IAIO,SAAS,GAAG,SAAS,oBAAoB,EAAE,CAF1E;IAED,IAAI,qBAAqB,CAAC,IAAI,EAAE,SAAS,GAAG,SAAS,oBAAoB,EAAE,EAO1E;CACJ"}

package/dist/esm/peer/PeerExchangeProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PeerExchangeProvider.d.ts","sourceRoot":"","sources":["../../../src/peer/PeerExchangeProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAiB,MAAM,iBAAiB,CAAC;AAEvE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,gBAAgB;;IAItD,YAAY,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,CAAC,OAAO,EAKtD;IAED,IAAI,iBAAiB,WAEpB;IAED,IAAI,WAAW,gBAEd;IAED;;;OAGG;IACH,IAAI,WAAW,gBAMd;IAEc,OAAO,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAUlE;IAEc,gBAAgB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAiEtF;IAEQ,uBAAuB,CAAC,sBAAsB,CAAC,EAAE,QAAQ,EAAE,yBAAyB,CAAC,EAAE,OAAO,GAAG,QAAQ,CAQjH;CACJ"}
+{"version":3,"file":"PeerExchangeProvider.d.ts","sourceRoot":"","sources":["../../../src/peer/PeerExchangeProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AACrF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAEpE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAiB,MAAM,iBAAiB,CAAC;AAEvE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAErD;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,gBAAgB;;IAItD,YAAY,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,cAAc,CAAC,OAAO,EAKtD;IAED,IAAI,iBAAiB,WAEpB;IAED,IAAI,WAAW,gBAEd;IAED;;;OAGG;IACH,IAAI,WAAW,gBAMd;IAEc,OAAO,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQlE;IAEc,gBAAgB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAqEtF;IAEQ,uBAAuB,CAAC,sBAAsB,CAAC,EAAE,QAAQ,EAAE,yBAAyB,CAAC,EAAE,OAAO,GAAG,QAAQ,CAQjH;CACJ"}

package/dist/esm/peer/PeerSet.d.ts

@@ -6,7 +6,7 @@
 import { PeerAddress } from "#peer/PeerAddress.js";
 import { ExchangeManager } from "#protocol/ExchangeManager.js";
 import { SessionManager } from "#session/SessionManager.js";
-import { AsyncObservable, BasicSet, DnssdNames, Environment, Environmental, ImmutableSet, Lifetime, ObservableSet, RetrySchedule } from "@matter/general";
+import { AsyncObservable, BasicSet, ChannelType, DnssdNames, Environment, Environmental, ImmutableSet, Lifetime, ObservableSet, RetrySchedule } from "@matter/general";
 import { NetworkProfiles } from "./NetworkProfile.js";
 import { Peer } from "./Peer.js";
 import { PeerConnection } from "./PeerConnection.js";
@@ -35,6 +35,12 @@ export declare class PeerSet implements ImmutableSet<Peer>, ObservableSet<Peer>
     get deleted(): import("@matter/general").Observable<[Peer], void>;
     get empty(): import("@matter/general").ObservableValue<[boolean], void>;
     get disconnected(): AsyncObservable<[peer: Peer], void>;
+    /**
+     * Default outgoing transport preference applied to peers created by this set when they have
+     * no per-peer override. Honored as a soft preference at connect time.
+     */
+    get transportPreference(): ChannelType.TCP | undefined;
+    set transportPreference(pref: ChannelType.TCP | undefined);
     /**
      * Unconditional get.
      *

package/dist/esm/peer/PeerSet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PeerSet.d.ts","sourceRoot":"","sources":["../../../src/peer/PeerSet.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAEH,eAAe,EACf,QAAQ,EAER,UAAU,EACV,WAAW,EACX,aAAa,EACb,YAAY,EAIZ,QAAQ,EAGR,aAAa,EAEb,aAAa,EAEhB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC;IACzB,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,eAAe,CAAC;IAC1B,iBAAiB,CAAC,EAAE,aAAa,CAAC;IAClC,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,WAAW,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;CACvD;AAED;;GAEG;AACH,qBAAa,OAAQ,YAAW,YAAY,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC;;IAUnE,YAAY,OAAO,EAAE,cAAc,EAsDlC;IAED,IAAI,SAAS,CAAC,SAAS,EAAE,eAAe,GAAG,SAAS,EAEnD;IAED,IAAI,KAAK,uDAER;IAED,IAAI,OAAO,uDAEV;IAED,IAAI,KAAK,+DAER;IAED,IAAI,YAAY,wCAEf;IAED;;;;OAIG;IACH,GAAG,CAAC,OAAO,EAAE,WAAW,QAUvB;IAED,GAAG,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,GAAG,IAAI,WAE5C;IAED,IAAI,IAAI,WAEP;IAED,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,GAAG,SAAS,oBAElD;IAED,MAAM,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,GAAG,SAAS,UAEpD;IAED,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,OAE/B;IAED,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAEhB;IAED,MAAM,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,WAAW,WAS7C;IAED,IAAI,KAAK,yBAER;IAED,IAAI,QAAQ,oBAEX;IAED,IAAI,MAAM,IAIS,OAAO,CAAC,oBAAoB,CAAC,CAF/C;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,EAE/C;IAED,IAAI,WAAW,CAAC,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,aAAa,CAAC,EAE7D;IAED;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,oBAKrC;IAED;;;;OAIG;IACG,UAAU,kBASf;IAEK,KAAK,kBAQV;IAsBD,YAAY,CAAC,UAAU,EAAE,cAAc,QA8BtC;CACJ"}
+{"version":3,"file":"PeerSet.d.ts","sourceRoot":"","sources":["../../../src/peer/PeerSet.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAEH,eAAe,EACf,QAAQ,EACR,WAAW,EACX,UAAU,EACV,WAAW,EACX,aAAa,EACb,YAAY,EAIZ,QAAQ,EAGR,aAAa,EAEb,aAAa,EAEhB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAsB,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,cAAc;IAC3B,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC;IACzB,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,EAAE,UAAU,CAAC;IAClB,QAAQ,EAAE,eAAe,CAAC;IAC1B,iBAAiB,CAAC,EAAE,aAAa,CAAC;IAClC,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,WAAW,CAAC,EAAE,cAAc,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;CACvD;AAED;;GAEG;AACH,qBAAa,OAAQ,YAAW,YAAY,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC;;IAWnE,YAAY,OAAO,EAAE,cAAc,EAsDlC;IAED,IAAI,SAAS,CAAC,SAAS,EAAE,eAAe,GAAG,SAAS,EAEnD;IAED,IAAI,KAAK,uDAER;IAED,IAAI,OAAO,uDAEV;IAED,IAAI,KAAK,+DAER;IAED,IAAI,YAAY,wCAEf;IAED;;;OAGG;IACH,IAAI,mBAAmB,IAIO,WAAW,CAAC,GAAG,GAAG,SAAS,CAFxD;IAED,IAAI,mBAAmB,CAAC,IAAI,EAAE,WAAW,CAAC,GAAG,GAAG,SAAS,EAExD;IAED;;;;OAIG;IACH,GAAG,CAAC,OAAO,EAAE,WAAW,QAWvB;IAQD,GAAG,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,GAAG,IAAI,WAE5C;IAED,IAAI,IAAI,WAEP;IAED,IAAI,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,GAAG,SAAS,oBAElD;IAED,MAAM,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,GAAG,SAAS,UAEpD;IAED,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,OAE/B;IAED,CAAC,MAAM,CAAC,QAAQ,CAAC,sBAEhB;IAED,MAAM,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,WAAW,WAS7C;IAED,IAAI,KAAK,yBAER;IAED,IAAI,QAAQ,oBAEX;IAED,IAAI,MAAM,IAIS,OAAO,CAAC,oBAAoB,CAAC,CAF/C;IAED,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,oBAAoB,CAAC,EAE/C;IAED,IAAI,WAAW,CAAC,OAAO,EAAE,cAAc,CAAC,OAAO,CAAC,aAAa,CAAC,EAE7D;IAED;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,WAAW,GAAG,cAAc,oBAKrC;IAED;;;;OAIG;IACG,UAAU,kBASf;IAEK,KAAK,kBAQV;IAsBD,YAAY,CAAC,UAAU,EAAE,cAAc,QA+BtC;CACJ"}

package/dist/esm/protocol/ExchangeProvider.d.ts

@@ -38,6 +38,12 @@ export interface NewExchangeOptions extends Omit<InteractionSettings, "transacti
     requireExistingSession?: boolean;
     /** Required transport type for this exchange. If set, only sessions of this transport type are used. */
     requiredTransport?: ChannelType;
+    /**
+     * Per-call soft transport preference. Honored only when the peer advertises matching server
+     * capability; otherwise the connect path falls back to UDP. Has no effect when
+     * {@link requiredTransport} is set.
+     */
+    preferredTransport?: ChannelType;
 }
 /**
  * Interface for obtaining a message exchange with a specific peer.

package/dist/esm/protocol/ExchangeProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExchangeProvider.d.ts","sourceRoot":"","sources":["../../../src/protocol/ExchangeProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAI1E;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,mBAAmB,EAAE,aAAa,CAAC;IAChF;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,eAAe,CAAC,EAAE,gBAAgB,CAAC;IAEnC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC,wGAAwG;IACxG,iBAAiB,CAAC,EAAE,WAAW,CAAC;CACnC;AAED;;GAEG;AACH,8BAAsB,gBAAgB;IACtB,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,eAAe;IAA/D,YAA+B,eAAe,EAAE,eAAe,EAAI;IAEnE,QAAQ,CAAC,uBAAuB,CAAC,sBAAsB,CAAC,EAAE,QAAQ,EAAE,yBAAyB,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IACnH,QAAQ,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAClF,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC5C,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE7C;;;;;OAKG;IACH,IAAI,OAAO,IAAI,aAAa,GAAG,SAAS,CAEvC;IAED;;;;OAIG;IACG,OAAO,CAAC,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAG;CACjE;AAED;;GAEG;AACH,qBAAa,gCAAiC,SAAQ,gBAAgB;;IAGlE,YAAY,eAAe,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,EAGnE;IAED,IAAI,iBAAiB,WAEpB;IAEK,gBAAgB,IAAI,OAAO,CAAC,eAAe,CAAC,CAEjD;IAED,IAAI,WAAW,gBAEd;IAED,IAAa,OAAO,kBAEnB;IAED,uBAAuB,CACnB,sBAAsB,WAAuC,EAC7D,yBAAyB,CAAC,EAAE,OAAO,YAOtC;IAED,IAAI,WAAW;;;kBAId;CACJ"}
+{"version":3,"file":"ExchangeProvider.d.ts","sourceRoot":"","sources":["../../../src/protocol/ExchangeProvider.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAE/D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAI1E;;GAEG;AACH,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,mBAAmB,EAAE,aAAa,CAAC;IAChF;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,eAAe,CAAC,EAAE,gBAAgB,CAAC;IAEnC;;;OAGG;IACH,sBAAsB,CAAC,EAAE,OAAO,CAAC;IAEjC,wGAAwG;IACxG,iBAAiB,CAAC,EAAE,WAAW,CAAC;IAEhC;;;;OAIG;IACH,kBAAkB,CAAC,EAAE,WAAW,CAAC;CACpC;AAED;;GAEG;AACH,8BAAsB,gBAAgB;IACtB,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,eAAe;IAA/D,YAA+B,eAAe,EAAE,eAAe,EAAI;IAEnE,QAAQ,CAAC,uBAAuB,CAAC,sBAAsB,CAAC,EAAE,QAAQ,EAAE,yBAAyB,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IACnH,QAAQ,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;IAClF,QAAQ,CAAC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAC3C,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IAC5C,QAAQ,CAAC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE7C;;;;;OAKG;IACH,IAAI,OAAO,IAAI,aAAa,GAAG,SAAS,CAEvC;IAED;;;;OAIG;IACG,OAAO,CAAC,QAAQ,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAG;CACjE;AAED;;GAEG;AACH,qBAAa,gCAAiC,SAAQ,gBAAgB;;IAGlE,YAAY,eAAe,EAAE,eAAe,EAAE,OAAO,EAAE,aAAa,EAGnE;IAED,IAAI,iBAAiB,WAEpB;IAEK,gBAAgB,IAAI,OAAO,CAAC,eAAe,CAAC,CAEjD;IAED,IAAI,WAAW,gBAEd;IAED,IAAa,OAAO,kBAEnB;IAED,uBAAuB,CACnB,sBAAsB,WAAuC,EAC7D,yBAAyB,CAAC,EAAE,OAAO,YAOtC;IAED,IAAI,WAAW;;;kBAId;CACJ"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@matter/protocol",
-    "version": "0.17.0-alpha.0-20260507-059f7763b",
+    "version": "0.17.0-alpha.0-20260508-29ff5ae9e",
     "description": "Low-level APIs for Matter interaction",
     "keywords": [
         "iot",
@@ -35,12 +35,12 @@
         "#*": "./src/*"
     },
     "dependencies": {
-        "@matter/general": "0.17.0-alpha.0-20260507-059f7763b",
-        "@matter/model": "0.17.0-alpha.0-20260507-059f7763b",
-        "@matter/types": "0.17.0-alpha.0-20260507-059f7763b"
+        "@matter/general": "0.17.0-alpha.0-20260508-29ff5ae9e",
+        "@matter/model": "0.17.0-alpha.0-20260508-29ff5ae9e",
+        "@matter/types": "0.17.0-alpha.0-20260508-29ff5ae9e"
     },
     "devDependencies": {
-        "@matter/testing": "0.17.0-alpha.0-20260507-059f7763b"
+        "@matter/testing": "0.17.0-alpha.0-20260508-29ff5ae9e"
     },
     "files": [
         "dist/**/*",

package/src/action/client/ClientInteraction.ts

@@ -736,9 +736,10 @@ export class ClientInteraction<
             const batchNetwork = commandList.find(c => c.network !== undefined)?.network;
 
             // Use #invokeSingle directly to avoid re-entering the batching path in invoke()
-            // Always skip validation here — commands were already validated when originally submitted
+            // Skip validation: already validated on submit. timed=false: only non-timed commands
+            // reach this path (gate in invoke()); prevents Invoke() spec-based auto-promotion.
             const batchRequest = {
-                ...Invoke({ commands: invokeRequests, skipValidation: true }),
+                ...Invoke({ commands: invokeRequests, skipValidation: true, timed: false }),
                 network: batchNetwork,
             } as ClientInvoke;
             const maxPathsPerInvoke = this.#exchangeProvider.maxPathsPerInvoke ?? 1;