@decentnetwork/peer 0.1.30 → 0.1.32

package/dist/peer.js

@@ -586,7 +586,18 @@ export class Peer {
             const routes = await this.#discoverFriendRoutes(friendAddress.publicKey);
             this.#debugLog(`friend route discovery done routes=${routes.length}`);
             if (routes.length === 0) {
-                await this.#sendDirectCryptoFriendRequest(friendAddress.publicKey, friendReqPayload);
+                // The direct net_crypto send needs a known endpoint for the target; to
+                // a peer we've never connected to (a dora, an exit) it throws. The old
+                // code `await`ed it bare, so that throw skipped the express push below
+                // and the friend-request never went out by ANY channel — the exact
+                // reason callpass never reached dora-mac. Make it best-effort so the
+                // express fallback always runs.
+                try {
+                    await this.#sendDirectCryptoFriendRequest(friendAddress.publicKey, friendReqPayload);
+                }
+                catch (error) {
+                    this.#debugLog(`direct crypto friend-request to ${friendId} failed: ${error.message}`);
+                }
                 this.#lastFriendRequestDispatch = {
                     transport: "direct",
                     routes: 0,
@@ -840,7 +851,11 @@ export class Peer {
             return;
         }
         // Offline / fallback path via Carrier express HTTP store-and-forward.
-        if (this.#express?.hasNodes()) {
+        // Skipped entirely in control-plane-only mode (decentlan's data plane):
+        // a VPN-style daemon must fail fast when a friend is offline rather than
+        // silently queue IP packets into HTTPS storage that never get forwarded
+        // in real time. Express there is reserved for friend-request bootstrap.
+        if (this.#express?.hasNodes() && !this.#opts.expressControlPlaneOnly) {
             await this.#express.sendOfflineText(pubkey, packet);
             this.#debugLog(`sendText: queued via express for ${pubkey}`);
             return;

package/dist/types/peer.d.ts

@@ -17,6 +17,17 @@ export type PeerOptions = {
     friendStoreFile?: string;
     bootstrapNodes: NetworkNode[];
     expressNodes?: NetworkNode[];
+    /**
+     * When true, the express relay is used ONLY for friend-request
+     * bootstrap (a one-time control-plane handshake) and NEVER as a
+     * fallback for runtime `sendText` data. This lets a VPN-style data
+     * plane stay fail-fast (an offline friend surfaces as offline, IP
+     * packets don't silently pile into HTTPS store-and-forward) while
+     * still letting the initial friend-request reach a peer whose onion
+     * announce hasn't propagated. decentlan's daemon sets this; chat-style
+     * apps that genuinely want offline message delivery leave it false.
+     */
+    expressControlPlaneOnly?: boolean;
     compatibilityMode?: CompatibilityMode;
     debugLabel?: string;
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@decentnetwork/peer",
-  "version": "0.1.30",
+  "version": "0.1.32",
   "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",