Debug node response from browser

.changeset/perky-hands-sleep.md

@@ -0,0 +1,5 @@
+---
+'@lit-protocol/lit-client': patch
+---
+
+Browser apps can now enable raw Lit node HTTP response logging by setting window.DEBUG_HTTP='true' before loading the SDK

docs/docs.json

@@ -154,6 +154,7 @@
           {
             "group": "Resources",
             "pages": [
+              "sdk/resources/debug-logging",
               "sdk/resources/supported-evm-chains",
               "sdk/resources/network-status"
             ]

docs/sdk/resources/debug-logging.mdx

@@ -0,0 +1,57 @@
+---
+title: "Debug Logging"
+description: "Enable Lit JS SDK debug logging in browsers and Node.js."
+---
+
+# Overview
+
+Use SDK logs to inspect Lit Action requests and responses. Logging is disabled by default.
+
+## Browser
+
+Set `window.LOG_LEVEL` before the SDK bundle loads (or before your first `@lit-protocol/*` import). The logger is initialized at module load time, so setting it afterward will not take effect.
+
+```html
+<script>
+  window.LOG_LEVEL = 'debug';
+</script>
+<script type="module" src="/src/main.tsx"></script>
+```
+
+If your entrypoint is a module, set the flag before a dynamic import:
+
+```ts
+window.LOG_LEVEL = 'debug';
+const { createLitClient } = await import('@lit-protocol/lit-client');
+```
+
+## Node.js
+
+Set `LOG_LEVEL=debug` (or `info`) before running the app:
+
+```bash
+LOG_LEVEL=debug node app.js
+```
+
+## HTTP Response Logging
+
+Set `DEBUG_HTTP=true` to log raw HTTP responses and a generated `curl` command for each node request.
+
+```bash
+LOG_LEVEL=debug DEBUG_HTTP=true node app.js
+```
+
+In browsers, set the flag on `window` before the SDK loads:
+
+```html
+<script>
+  window.DEBUG_HTTP = 'true';
+  window.LOG_LEVEL = 'debug';
+</script>
+```
+
+## What You Can and Cannot See
+
+- The SDK does not surface decrypted per-node payloads in browser logs.
+- `executeJs` returns `result.response` and `result.logs` (aggregated console output from your Lit Action).
+- To inspect decrypted data, explicitly log or return it from the Lit Action (be careful with secrets).

packages/lit-client/src/lib/LitNodeClient/LitNodeApi/src/helper/sendNodeRequest.ts

@@ -20,6 +20,29 @@ function generateCurlCommand(url: string, req: any): string {
   return `curl -X ${req.method} ${headers} ${body} "${url}"`.trim();
 }
 
+const isDebugHttpEnabled = (): boolean => {
+  try {
+    if (
+      typeof process !== 'undefined' &&
+      typeof process.env === 'object' &&
+      process.env['DEBUG_HTTP'] === 'true'
+    ) {
+      return true;
+    }
+  } catch (e) {
+    // Ignore any errors - ensures browser compatibility
+  }
+
+  try {
+    const debugHttp = (globalThis as any).DEBUG_HTTP;
+    return debugHttp === true || debugHttp === 'true';
+  } catch (e) {
+    // Ignore any errors - ensures browser compatibility
+  }
+
+  return false;
+};
+
 export async function sendNodeRequest<T>(
   // Interface for common request parameters
   params: {
@@ -71,17 +94,7 @@ export async function sendNodeRequest<T>(
     const response = await fetch(_fullUrl, req);
 
     // Only log response details when DEBUG_HTTP is enabled
-    // Safely check for DEBUG_HTTP environment variable in both Node.js and browser
-    let isDebugMode = false;
-    try {
-      isDebugMode =
-        typeof process !== 'undefined' &&
-        typeof process.env === 'object' &&
-        process.env['DEBUG_HTTP'] === 'true';
-    } catch (e) {
-      // Ignore any errors - ensures browser compatibility
-      isDebugMode = false;
-    }
+    const isDebugMode = isDebugHttpEnabled();
 
     if (isDebugMode) {
       const timestamp = new Date().toISOString();