@decentnetwork/lan 0.1.31 → 0.1.32

package/dist/carrier/peer-manager.d.ts

@@ -73,6 +73,15 @@ export declare class PeerManager extends EventEmitter {
      * Status shape.
      */
     getSessionStatus(pubkey: string): ReturnType<Peer["sessionStatus"]> | null;
+    /**
+     * DHT health snapshot — surfaces the underlying-network layers that
+     * have to work for UDP holepunch to succeed. Surfaced via
+     * `agentnet diag` so an operator can tell at a glance whether the
+     * "every session stuck on tcp-relay" pain is due to DHT discovery
+     * failing (selfAnnounceStoredOn=0), UDP socket missing
+     * (udpLocalPort=null), or just the relay-only path doing its job.
+     */
+    getDhtHealth(): ReturnType<Peer["dhtHealth"]> | null;
     /**
      * Check if a specific friend is currently online (direct UDP path established).
      * Returns false for unknown pubkeys.

package/dist/carrier/peer-manager.js

@@ -197,6 +197,19 @@ export class PeerManager extends EventEmitter {
             return null;
         return this.peer.sessionStatus(pubkey);
     }
+    /**
+     * DHT health snapshot — surfaces the underlying-network layers that
+     * have to work for UDP holepunch to succeed. Surfaced via
+     * `agentnet diag` so an operator can tell at a glance whether the
+     * "every session stuck on tcp-relay" pain is due to DHT discovery
+     * failing (selfAnnounceStoredOn=0), UDP socket missing
+     * (udpLocalPort=null), or just the relay-only path doing its job.
+     */
+    getDhtHealth() {
+        if (!this.peer)
+            return null;
+        return this.peer.dhtHealth();
+    }
     /**
      * Check if a specific friend is currently online (direct UDP path established).
      * Returns false for unknown pubkeys.

package/dist/daemon/server.js

@@ -244,6 +244,7 @@ export class DaemonServer {
                         identity: this.peerManager?.getIdentity(),
                         tun: this.tunDevice?.getConfig(),
                         allocatedIp: this.doraIntegration?.getAllocatedIp() ?? this.config.network.ip,
+                        dht: this.peerManager?.getDhtHealth() ?? null,
                         dns: this.dnsServer
                             ? { domain: this.dnsServer.getDomain(), port: this.dnsServer.getBoundPort() }
                             : null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decentnetwork/lan",
-  "version": "0.1.31",
+  "version": "0.1.32",
   "description": "Private virtual LAN for self-hosted services and AI agents, built on Elastos Carrier. NAT-traversal, name service, ACL, all over a peer-to-peer mesh — no public IP required.",
   "type": "module",
   "main": "./dist/index.js",
@@ -74,7 +74,7 @@
   },
   "dependencies": {
     "@decentnetwork/dora": "^0.1.0",
-    "@decentnetwork/peer": "^0.1.5",
+    "@decentnetwork/peer": "^0.1.6",
     "js-yaml": "^4.1.0",
     "yargs": "^17.7.2"
   },