@matter-server/dashboard 0.2.7-alpha.0-20260118-993a1c7 → 0.2.7-alpha.0-20260119-49e7237

package/src/util/format_hex.ts

@@ -5,7 +5,7 @@
  */
 
 /**
- * Format a number as a hex string with 0x prefix.
+ * Format a number or bigint as a hex string with 0x prefix.
  * Ensures even number of digits with a minimum of 4 digits.
  *
  * Examples:
@@ -14,7 +14,7 @@
  *   65535 -> "0xFFFF"
  *   65536 -> "0x010000"
  */
-export function formatHex(value: number): string {
+export function formatHex(value: number | bigint): string {
     let hex = value.toString(16).toUpperCase();
 
     // Ensure minimum 4 digits
@@ -28,3 +28,18 @@ export function formatHex(value: number): string {
 
     return `0x${hex}`;
 }
+
+/**
+ * Format a node address in Matter format: @fabricIndex:nodeIdHex
+ * For test nodes (where fabric index is unknown), uses "?" as the fabric index.
+ *
+ * Examples:
+ *   (1, 2) -> "@1:2"
+ *   (1, 255) -> "@1:ff"
+ *   (2, 65535) -> "@2:ffff"
+ *   (undefined, 2) -> "@?:2"
+ */
+export function formatNodeAddress(fabricIndex: number | undefined, nodeId: number | bigint): string {
+    const fabricPart = fabricIndex !== undefined ? fabricIndex : "?";
+    return `@${fabricPart}:${nodeId.toString(16)}`;
+}