@decentnetwork/peer 0.1.3 → 0.1.4

package/dist/peer.d.ts

@@ -71,6 +71,28 @@ export declare class Peer {
         hasTcpRoute: boolean;
         transport: "udp" | "tcp-relay" | "both" | "none";
         lastPingRecvMs: number | null;
+        /** OS-assigned UDP port THIS node is listening on. Useful to confirm
+         *  we even have a UDP socket bound. */
+        ourLocalUdpPort: number | null;
+        /** Cached UDP endpoint for the peer from a previous online state
+         *  (persisted across restarts). Set != null means UDP holepunch
+         *  has succeeded at some point — but null when we've only ever
+         *  reached them via TCP-relay. Tells us whether discovery has
+         *  ever found a usable UDP endpoint. */
+        friendUdpEndpoint: {
+            host: string;
+            port: number;
+        } | null;
+        /** UDP endpoints picked up by recent DHT discovery for this peer,
+         *  whether or not the cookie exchange has succeeded yet. If this
+         *  is empty AND friendUdpEndpoint is null AND we keep getting
+         *  tcp-relay, discovery itself is broken — we don't even know
+         *  where to send a cookie request. */
+        endpointCandidatesCount: number;
+        /** Last time we sent an outbound cookie request via UDP for this
+         *  peer (null = never). Used to confirm Phase 1.2 retries are
+         *  actually firing. */
+        cookieRequestSentMs: number | null;
     } | null;
     waitForFriendRequest(timeoutMs?: number): Promise<FriendRequest>;
 }

package/dist/peer.js

@@ -772,6 +772,7 @@ export class Peer {
         const s = this.#friendSessions.get(pubkey);
         if (!s)
             return null;
+        const friend = this.#friends.get(pubkey);
         // session.remote can be a synthetic `tcp:<dhtpk>:0` placeholder
         // when the TCP relay path reports an endpoint with no real UDP
         // address; treat those as no-UDP for reporting.
@@ -785,12 +786,22 @@ export class Peer {
             : s.hasTcpRoute
                 ? "tcp-relay"
                 : "none";
+        const friendUdp = friend?.remoteHost &&
+            friend.remotePort &&
+            !friend.remoteHost.startsWith("tcp:") &&
+            friend.remotePort !== 0
+            ? { host: friend.remoteHost, port: friend.remotePort }
+            : null;
         return {
             established: s.established === true,
             udpRemote: realUdp,
             hasTcpRoute: s.hasTcpRoute === true,
             transport,
             lastPingRecvMs: s.lastPingRecvMs ?? null,
+            ourLocalUdpPort: this.#udp?.localPort() ?? null,
+            friendUdpEndpoint: friendUdp,
+            endpointCandidatesCount: s.endpointCandidates?.length ?? 0,
+            cookieRequestSentMs: s.cookieRequestSentMs ?? null,
         };
     }
     waitForFriendRequest(timeoutMs = 30000) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decentnetwork/peer",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Pure TypeScript port of Elastos Carrier (toxcore-derived) P2P messaging. DHT, onion routing, TCP relay, FlatBuffers app payloads, Express offline relay. Wire-compatible with iOS Beagle and the Carrier C SDK.",
   "type": "module",
   "main": "./dist/index.js",