@decentnetwork/lan 0.1.23 → 0.1.24

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

@@ -2,6 +2,7 @@
  * Manages Carrier peer identity and connections
  * Wraps @decentnetwork/peer SDK
  */
+import { Peer } from "@decentnetwork/peer";
 import { EventEmitter } from "events";
 import { PacketSession } from "./packet-session.js";
 import type { PeerIdentity, RemotePeer } from "./types.js";
@@ -62,6 +63,16 @@ export declare class PeerManager extends EventEmitter {
     getHexPubkey(): string;
     getAddress(): string;
     getFriends(): RemotePeer[];
+    /**
+     * Snapshot of the underlying net_crypto session — UDP-direct vs
+     * TCP-relay vs not-yet-established. Surfaces what's behind a
+     * "friend.status === online" so an operator can see whether
+     * latency is going via a fast direct UDP path or via a TCP relay.
+     * Returns null if the SDK has no session record for the pubkey
+     * yet (i.e. handshake hasn't happened). See peer.ts for the
+     * Status shape.
+     */
+    getSessionStatus(pubkey: string): ReturnType<Peer["sessionStatus"]> | null;
     /**
      * Check if a specific friend is currently online (direct UDP path established).
      * Returns false for unknown pubkeys.

package/dist/carrier/peer-manager.js

@@ -183,6 +183,20 @@ export class PeerManager extends EventEmitter {
             };
         });
     }
+    /**
+     * Snapshot of the underlying net_crypto session — UDP-direct vs
+     * TCP-relay vs not-yet-established. Surfaces what's behind a
+     * "friend.status === online" so an operator can see whether
+     * latency is going via a fast direct UDP path or via a TCP relay.
+     * Returns null if the SDK has no session record for the pubkey
+     * yet (i.e. handshake hasn't happened). See peer.ts for the
+     * Status shape.
+     */
+    getSessionStatus(pubkey) {
+        if (!this.peer)
+            return null;
+        return this.peer.sessionStatus(pubkey);
+    }
     /**
      * Check if a specific friend is currently online (direct UDP path established).
      * Returns false for unknown pubkeys.

package/dist/daemon/server.js

@@ -202,6 +202,13 @@ export class DaemonServer {
                             status: f.status,
                             address: f.address,
                             acceptedAt: f.acceptedAt,
+                            // Transport state of the underlying net_crypto session.
+                            // Surface this so operators can tell "online via direct UDP
+                            // (~80ms RTT)" from "online via TCP relay (~500ms+ RTT)" —
+                            // the difference matters a lot and `status: online` hides it.
+                            // Null when no session record exists yet (handshake hasn't
+                            // happened).
+                            session: this.peerManager?.getSessionStatus(f.pubkey) ?? null,
                         })),
                         ipam: ipamPeers,
                     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decentnetwork/lan",
-  "version": "0.1.23",
+  "version": "0.1.24",
   "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",