@decentnetwork/peer 0.1.31 → 0.1.32

package/dist/peer.js

@@ -851,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.31",
+  "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",