@decentnetwork/peer 0.1.143 → 0.1.144

package/dist/peer.js

@@ -373,6 +373,10 @@ export class Peer {
     #knownNodes;
     #announceDataKey;
     #lastSelfAnnounceMs = 0;
+    // Env vars OR an explicit option. A browser has no process.env, so peer
+    // debugging there was simply unreachable — which is why the browser client
+    // has been a black box every time it misbehaved. The option is the only way
+    // in from a page.
     #debug = process.env.DECENT_DEBUG === "1" || process.env.DECENT_DEBUG_VERBOSE === "1";
     #debugVerbose = process.env.DECENT_DEBUG_VERBOSE === "1";
     #packetTrace = process.env.DECENT_PACKET_TRACE === "1";
@@ -538,6 +542,15 @@ export class Peer {
             ...opts,
             compatibilityMode: opts.compatibilityMode ?? "legacy"
         };
+        // A browser has no process.env, so the env-var switches above can never
+        // be set there and peer debugging was unreachable from a page. That is
+        // why every browser misbehaviour has had to be diagnosed by inference.
+        if (opts.debug)
+            this.#debug = true;
+        if (opts.debugVerbose) {
+            this.#debug = true;
+            this.#debugVerbose = true;
+        }
         this.#knownNodes = [...opts.bootstrapNodes];
         this.#friendStoreFile = opts.friendStoreFile ?? `${opts.keyFile}.friends.json`;
         // Enable resumable (断点续传) receives when the app gives us a directory to

package/dist/types/peer.d.ts

@@ -100,6 +100,10 @@ export type PeerOptions = {
      *  of it never runs: self-announce (so nobody can find this peer) and the
      *  express pull loop (so offline messages are never collected). */
     tcpOnlyBootstrap?: boolean;
+    /** Turn on peer debug logging without env vars — the only route in from a
+     *  browser, where process.env does not exist. */
+    debug?: boolean;
+    debugVerbose?: boolean;
     compatibilityMode?: CompatibilityMode;
     debugLabel?: string;
 };

package/package.json

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