@matter/protocol 0.16.0-alpha.0-20251205-dfb1e1556 → 0.16.0-alpha.0-20251209-d6072d23e

package/dist/esm/peer/PeerDescriptor.js

@@ -0,0 +1,51 @@
+/**
+ * @license
+ * Copyright 2022-2025 Matter.js Authors
+ * SPDX-License-Identifier: Apache-2.0
+ */
+import { isDeepEqual } from "#general";
+import { PeerAddress } from "./PeerAddress.js";
+class ObservablePeerDescriptor {
+  #address;
+  #operationalAddress;
+  #discoveryData;
+  #dataStore;
+  #onChange;
+  constructor({ address, operationalAddress, discoveryData, dataStore }, onChange) {
+    this.#address = PeerAddress(address);
+    this.#operationalAddress = operationalAddress;
+    this.#discoveryData = discoveryData;
+    this.#dataStore = dataStore;
+    this.#onChange = onChange;
+  }
+  get address() {
+    return this.#address;
+  }
+  get operationalAddress() {
+    return this.#operationalAddress;
+  }
+  set operationalAddress(value) {
+    if (isDeepEqual(this.#operationalAddress, value)) {
+      return;
+    }
+    this.#operationalAddress = value;
+    this.#onChange();
+  }
+  get discoveryData() {
+    return this.#discoveryData;
+  }
+  set discoveryData(value) {
+    if (isDeepEqual(value, this.#discoveryData)) {
+      return;
+    }
+    this.#discoveryData = { ...this.#discoveryData, ...value };
+    this.#onChange();
+  }
+  get dataStore() {
+    return this.#dataStore;
+  }
+}
+export {
+  ObservablePeerDescriptor
+};
+//# sourceMappingURL=PeerDescriptor.js.map

package/dist/esm/peer/PeerDescriptor.js.map

@@ -0,0 +1,6 @@
+{
+  "version": 3,
+  "sources": ["../../../src/peer/PeerDescriptor.ts"],
+  "mappings": "AAAA;AAAA;AAAA;AAAA;AAAA;AAOA,SAAS,mBAAqC;AAE9C,SAAS,mBAAmB;AA+BrB,MAAM,yBAAmD;AAAA,EAC5D;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA,YAAY,EAAE,SAAS,oBAAoB,eAAe,UAAU,GAAmB,UAAsB;AACzG,SAAK,WAAW,YAAY,OAAO;AACnC,SAAK,sBAAsB;AAC3B,SAAK,iBAAiB;AACtB,SAAK,aAAa;AAClB,SAAK,YAAY;AAAA,EACrB;AAAA,EAEA,IAAI,UAAU;AACV,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,qBAAqB;AACrB,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,mBAAmB,OAAqC;AACxD,QAAI,YAAY,KAAK,qBAAqB,KAAK,GAAG;AAC9C;AAAA,IACJ;AAEA,SAAK,sBAAsB;AAC3B,SAAK,UAAU;AAAA,EACnB;AAAA,EAEA,IAAI,gBAAgB;AAChB,WAAO,KAAK;AAAA,EAChB;AAAA,EAEA,IAAI,cAAc,OAAkC;AAChD,QAAI,YAAY,OAAO,KAAK,cAAc,GAAG;AACzC;AAAA,IACJ;AAEA,SAAK,iBAAiB,EAAE,GAAG,KAAK,gBAAgB,GAAG,MAAM;AACzD,SAAK,UAAU;AAAA,EACnB;AAAA,EAEA,IAAI,YAAY;AACZ,WAAO,KAAK;AAAA,EAChB;AACJ;",
+  "names": []
+}

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

@@ -4,17 +4,17 @@
  * SPDX-License-Identifier: Apache-2.0
  */
 import { DiscoveryData, ScannerSet } from "#common/Scanner.js";
-import { AsyncObservable, BasicSet, ConnectionlessTransportSet, Construction, Duration, Environment, Environmental, ImmutableSet, MatterError, ObservableSet, ServerAddressUdp } from "#general";
+import { AsyncObservable, BasicSet, ConnectionlessTransportSet, Construction, Duration, Environment, Environmental, ImmutableSet, Lifetime, MatterError, ObservableSet, ServerAddressUdp } from "#general";
 import { PeerAddress } from "#peer/PeerAddress.js";
-import { ChannelManager } from "#protocol/ChannelManager.js";
 import { ExchangeManager } from "#protocol/ExchangeManager.js";
 import { DedicatedChannelExchangeProvider, ReconnectableExchangeProvider } from "#protocol/ExchangeProvider.js";
-import { MessageChannel } from "#protocol/MessageChannel.js";
+import { SecureSession } from "#session/SecureSession.js";
 import { SessionManager } from "#session/SessionManager.js";
 import { CaseAuthenticatedTag } from "#types";
 import { InteractionQueue } from "./InteractionQueue.js";
-import { OperationalPeer } from "./OperationalPeer.js";
+import { Peer } from "./Peer.js";
 import { PeerAddressStore } from "./PeerAddressStore.js";
+import { PeerDescriptor } from "./PeerDescriptor.js";
 /**
  * Types of discovery that may be performed when connecting operationally.
  */
@@ -50,8 +50,8 @@ export interface PeerConnectionOptions {
  * Interfaces {@link PeerSet} with other components.
  */
 export interface PeerSetContext {
+    lifetime: Lifetime.Owner;
     sessions: SessionManager;
-    channels: ChannelManager;
     exchanges: ExchangeManager;
     scanners: ScannerSet;
     transports: ConnectionlessTransportSet;
@@ -60,22 +60,28 @@ export interface PeerSetContext {
 /**
  * Manages operational connections to peers on shared fabric.
  */
-export declare class PeerSet implements ImmutableSet<OperationalPeer>, ObservableSet<OperationalPeer> {
+export declare class PeerSet implements ImmutableSet<Peer>, ObservableSet<Peer> {
     #private;
     constructor(context: PeerSetContext);
-    get added(): import("#general").Observable<[OperationalPeer], void>;
-    get deleted(): import("#general").Observable<[OperationalPeer], void>;
+    get added(): import("#general").Observable<[Peer], void>;
+    get deleted(): import("#general").Observable<[Peer], void>;
     get empty(): import("#general").ObservableValue<[boolean], void>;
-    get disconnected(): AsyncObservable<[address: PeerAddress], void>;
-    has(item: PeerAddress | OperationalPeer): boolean;
+    get disconnected(): AsyncObservable<[peer: Peer], void>;
+    /**
+     * Unconditional get.
+     *
+     * Creates the peer if not already present.
+     */
+    for(address: PeerAddress): Peer;
+    has(item: PeerAddress | PeerDescriptor | Peer): boolean;
     get size(): number;
-    find(predicate: (item: OperationalPeer) => boolean | undefined): OperationalPeer | undefined;
-    filter(predicate: (item: OperationalPeer) => boolean | undefined): OperationalPeer[];
-    map<T>(mapper: (item: OperationalPeer) => T): T[];
-    [Symbol.iterator](): SetIterator<OperationalPeer>;
+    find(predicate: (item: Peer) => boolean | undefined): Peer | undefined;
+    filter(predicate: (item: Peer) => boolean | undefined): Peer[];
+    map<T>(mapper: (item: Peer) => T): T[];
+    [Symbol.iterator](): SetIterator<Peer>;
     get construction(): Construction<PeerSet>;
     static [Environmental.create](env: Environment): PeerSet;
-    get peers(): BasicSet<OperationalPeer, OperationalPeer>;
+    get peers(): BasicSet<Peer, Peer>;
     get interactionQueue(): InteractionQueue;
     connect(address: PeerAddress, options: PeerConnectionOptions & {
         operationalAddress?: ServerAddressUdp;
@@ -84,20 +90,11 @@ export declare class PeerSet implements ImmutableSet<OperationalPeer>, Observabl
      * Obtain an exchange provider for the designated peer.
      * TODO enhance PeerConnectionOptions.discoveryOptions.discoveryData with "addresses" for known operational addresses
      */
-    exchangeProviderFor(addressOrChannel: PeerAddress | MessageChannel, options?: PeerConnectionOptions): Promise<DedicatedChannelExchangeProvider | ReconnectableExchangeProvider>;
+    exchangeProviderFor(addressOrSession: PeerAddress | SecureSession, options?: PeerConnectionOptions): Promise<DedicatedChannelExchangeProvider | ReconnectableExchangeProvider>;
     /**
      * Retrieve a peer by address.
      */
-    get(peer: PeerAddress | OperationalPeer): OperationalPeer | undefined;
-    /**
-     * Terminate any active peer connection.
-     * Also handles unknown peers
-     */
-    disconnect(peer: PeerAddress | OperationalPeer, sendSessionClose?: boolean): Promise<void>;
-    /**
-     * Forget a known peer.
-     */
-    delete(peer: PeerAddress | OperationalPeer): Promise<void>;
+    get(peer: PeerAddress | PeerDescriptor): Peer | undefined;
     close(): Promise<void>;
     addKnownPeer(address: PeerAddress, operationalServerAddress?: ServerAddressUdp, discoveryData?: DiscoveryData): Promise<void>;
 }

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

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