/** * @license * Copyright 2022-2026 Matter.js Authors * SPDX-License-Identifier: Apache-2.0 */ import { DiagnosticPresentation } from "@matter/general"; import { FabricIndex, GroupId, NodeId } from "@matter/types"; /** * This is the "logical" address of a peer node consisting of a fabric and node ID. */ export interface PeerAddress { fabricIndex: FabricIndex; nodeId: NodeId; } const interned = Symbol("interned-logical-address"); const internedAddresses = new Map>(); /** * Obtain a canonical instance of a logical address. * * This allows for identification based on object comparison. Interned addresses render to a string in the format * "@:" */ export function PeerAddress(address: T): T { if (address === undefined) { return undefined as T; } if (interned in address) { return address; } let internedFabric = internedAddresses.get(address.fabricIndex); if (internedFabric === undefined) { internedAddresses.set(address.fabricIndex, (internedFabric = new Map())); } let internedAddress = internedFabric.get(address.nodeId); if (internedAddress) { return internedAddress as T; } internedAddress = InternedAddress(address); internedFabric.set(address.nodeId, internedAddress); return internedAddress as T; } const InternedAddressPrototoype = {}; Object.defineProperties(InternedAddressPrototoype, { [interned]: { value: true }, toString: { value() { return `@${this.fabricIndex.toString(16)}:${this.nodeId.toString(16)}`; }, }, [DiagnosticPresentation.value]: { get() { return this.toString(); }, }, }); function InternedAddress(address: PeerAddress): PeerAddress { const interned = Object.create(InternedAddressPrototoype, { fabricIndex: { value: address.fabricIndex, enumerable: true }, nodeId: { value: address.nodeId, enumerable: true }, }); Object.freeze(interned); return interned; } export namespace PeerAddress { export function is(addr1?: Readonly, addr2?: Readonly) { if (addr1 === undefined || addr2 === undefined) { return false; } return addr1.fabricIndex === addr2.fabricIndex && addr1.nodeId === addr2.nodeId; } export function isGroup(address: PeerAddress): boolean { return GroupId.isGroupNodeId(address.nodeId); } } /** * A collection of items keyed by logical address. */ export class PeerAddressMap extends Map { override delete(key: PeerAddress) { return super.delete(PeerAddress(key)); } override has(key: PeerAddress) { return super.has(PeerAddress(key)); } override set(key: PeerAddress, value: T) { return super.set(PeerAddress(key), value); } override get(key: PeerAddress) { return super.get(PeerAddress(key)); } } export class PeerAddressSet extends Set { override add(value: PeerAddress) { return super.add(PeerAddress(value)); } override has(value: PeerAddress) { return super.has(PeerAddress(value)); } override delete(value: PeerAddress) { return super.delete(PeerAddress(value)); } }