devlinker 1.3.8__tar.gz → 1.4.1__tar.gz

{devlinker-1.3.8/devlinker.egg-info → devlinker-1.4.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: devlinker
-Version: 1.3.8
+Version: 1.4.1
 Summary: A lightweight proxy that combines your frontend and backend into one link for easy development and sharing.
 Author-email: Mani <mani1028@users.noreply.github.com>
 Requires-Python: >=3.7
@@ -11,20 +11,26 @@ Requires-Dist: docker
 Requires-Dist: fastapi
 Requires-Dist: httpx
 Requires-Dist: pyngrok
+Requires-Dist: qrcode[pil]
 Requires-Dist: requests
+Requires-Dist: rich
 Requires-Dist: uvicorn
 Requires-Dist: websockets
 Dynamic: license-file
 
 # Dev Linker
 
-Dev Linker runs frontend and backend dev servers, proxies both through a single local port (8000), and creates a single public URL via Cloudflare or ngrok.
+Dev Linker starts your local development stack and routes frontend and backend traffic through one proxy URL, with optional LAN and public sharing.
 
 
 ## Features
 
 - 🚀 **Unified Dev Proxy:** Combines frontend (Vite/React) and backend (FastAPI/Flask/Node/Docker) into a single local and public URL.
 - 🔍 **Auto Detection:** Detects frontend/backend ports, runtime, Docker containers, and Vite servers automatically.
+- 📡 **Debug Request Logger:** Live API traffic lines (method, path, status, latency) only in debug mode.
+- 🧩 **Backend-Only Mode:** If no frontend is detected, DevLinker still runs and forwards all traffic to backend.
+- 🔁 **Auto API URL Sync:** Updates `frontend/.env.local` with `VITE_API_URL=http://localhost:<proxy-port>` using a managed block.
+- 🛡️ **Proxy CORS + Preflight:** Handles common CORS/preflight behavior at the proxy layer, including credential-safe Origin handling.
 - 🧠 **Smart Detection & Doctor:** Real-time request analysis, backend intelligence, log analyzer, and `devlinker doctor` for instant diagnostics.
 - 🛡️ **Auto-Fix Engine:** `devlinker fix` applies safe fixes (like VITE_API_URL) and suggests code changes.
 - 🌍 **Public Sharing:** Share your local dev environment instantly with `--url` (startup) or `devlinker share` (runtime, no restart).
@@ -35,9 +41,21 @@ Dev Linker runs frontend and backend dev servers, proxies both through a single
 - 🧪 **Runtime Smoke Test:** Built-in test for end-to-end proxy validation.
 - 🛠️ **Extensible:** Modular architecture for future SaaS, dashboard, and team features.
 
+## Support DevLinker
+
+If DevLinker helps you ship faster, consider supporting the project:
+
+> 💖 Support DevLinker
+> [![UPI](https://img.shields.io/badge/UPI-devlinker%40upi-22c55e?style=for-the-badge)](upi://pay?pa=devlinker@upi&pn=DevLinker&cu=INR&tn=Support%20DevLinker%20Project%20🚀)
+> [![Donate](https://img.shields.io/badge/Support-Scan%20or%20Pay-0ea5e9?style=for-the-badge)](upi://pay?pa=devlinker@upi&pn=DevLinker&cu=INR&tn=Support%20DevLinker%20Project%20🚀)
+
+- 💖 UPI: devlinker@upi
+- 🔗 UPI link: upi://pay?pa=devlinker@upi&pn=DevLinker&cu=INR&tn=Support%20DevLinker%20Project%20🚀
+
 ## CLI Commands & Options
 
 - `devlinker` — Start proxy (local only, fast)
+- `devlinker support` — Show UPI support QR code in terminal
 - `devlinker --url` — Start with public tunnel (Cloudflare/ngrok)
 - `devlinker share` — Enable public tunnel at runtime (no restart)
 - `devlinker unshare` — Disable public tunnel at runtime
@@ -49,6 +67,7 @@ Dev Linker runs frontend and backend dev servers, proxies both through a single
 - `devlinker --no-lan` — Hide WLAN sharing URL
 - `devlinker --interactive-backend` — Prompt to choose backend if multiple found
 - `devlinker --proxy-port 18000` — Use custom proxy port
+- `devlinker --debug` — Enable debug mode (turns on live API request logger)
 - `devlinker --version` — Show version
 
 ## Project Structure
@@ -75,6 +94,12 @@ For local development:
 pip install .
 ```
 
+For editable local development:
+
+```bash
+pip install -e .
+```
+
 After publishing to PyPI:
 
 ```bash
@@ -87,34 +112,47 @@ pip install devlinker
 devlinker
 ```
 
-Typical startup output:
+Direct module run (without installing entrypoint script):
+
+```bash
+python -m devlinker.main
+```
+
+Typical startup output (TTY with Rich available):
 
 ```text
-Dev Linker v1.2.2
-
-[INFO] Mode: Auto (FastAPI async proxy + Docker detection)
-[INFO] Booting local services...
-[INFO] Detecting frontend/backend ports...
-[OK] Frontend -> 5173
-[OK] Backend  -> 5000
-
-[OK] Proxy ready at http://localhost:8000
-
-[OK] Tunnel provider: Cloudflare
-[OK] Public URL:
-    https://xxxx.trycloudflare.com
-Tip: Press Ctrl+Click to open link
-
-[INFO] Share this link with collaborators.
-
-DevLinker Ready (in 2.4s)
-Frontend: http://localhost:5173
-Backend:  http://localhost:5000
-Access Links:
-Local:  http://localhost:8000
-WLAN:   http://192.168.1.5:8000
-Public: https://xxxx.trycloudflare.com
-Tip: Press Ctrl+Click to open link
+╭─────────────────────────────╮
+│ ♾️  DevLinker v1.4.1        │
+│ Smart Local Dev Environment │
+╰─────────────────────────────╯
+
+✔ Detecting project...
+⏳ Booting local services...
+
+╭───────── DevLinker Ready ─────────╮
+│ Proxy     http://localhost:8001   │
+│ WLAN      http://192.168.1.3:8001 │
+│ Public    disabled (use --url)    │
+╰───────────────────────────────────╯
+
+✨ Ready in 5.5s
+Powered by DevLinker 🚀
+```
+
+Enable debug mode with live API request logging:
+
+```bash
+devlinker --debug
+```
+
+Debug mode request logger sample:
+
+```text
+🛠 Debug mode enabled: live API request logger is ON
+
+📡 Requests (Live)
+GET    /api/users               200  45ms
+POST   /api/login               401  120ms
 ```
 
 Version check:
@@ -147,15 +185,6 @@ devlinker --docker
 By default, DevLinker starts **fast local proxy only** (no tunnel). To enable a public tunnel, use the `--url` flag:
 
 
-```bash
-devlinker --url
-```
-
-In your terminal output, you'll see:
-
-
-URL, run:
-
 ```bash
 devlinker --url
 ```
@@ -164,11 +193,11 @@ This will start the proxy and open a public tunnel (Cloudflare or ngrok). The ou
 
 ```text
 🌍 Enabling public tunnel...
-[OK] Tunnel provider: Cloudflare
-[OK] Public URL:
+✔ Tunnel provider: Cloudflare
+✔ Public URL:
      https://xxxx.trycloudflare.com
-Tip: Press Ctrl+Click to open link
-[INFO] Share this link with collaborators.
+ℹ Tip: Ctrl+Click to open link
+ℹ Share this link with collaborators.
 ```
 
 To force tunnel off (even if --url is passed):
@@ -228,13 +257,11 @@ devlinker --frontend 5173 --backend 5000 --proxy-port 18000
 Default behavior also tries fallback ports automatically when 8000 is busy:
 
 ```text
-[WARN] Port 8000 in use
-[INFO] Using proxy port: 8001
+⚠ Port 8000 in use
+ℹ Using proxy port: 8001
 ```
 
-- 8001
-- 8002
-- 18000
+By default it scans the next 10 ports after the requested one, then tries `18000`.
 
 Frontend detection behavior:
 
@@ -253,6 +280,41 @@ fetch("/api/endpoint")
 
 Do not hardcode backend host URLs in frontend code.
 
+DevLinker also writes/updates a managed block in `frontend/.env.local`:
+
+```env
+# devlinker-managed:start
+VITE_API_URL=http://localhost:8001
+# devlinker-managed:end
+```
+
+This keeps frontend API calls consistently routed through the proxy.
+
+Use the proxy URL as your single entry point during development:
+
+```text
+http://localhost:<proxy-port>
+```
+
+Avoid direct backend calls like `http://localhost:5000` from browser-facing code.
+
+## Configuration File
+
+DevLinker loads config from the first file found in this order:
+
+1. `devlinker.yaml`
+2. `devlinker.yml`
+3. `devlinker.json`
+
+Example:
+
+```yaml
+frontend: 5173
+backend: 5000
+proxy_port: 8001
+tunnel: false
+```
+
 ## Backend Auto-Detection
 
 Backend port detection runs in this order:
@@ -308,12 +370,15 @@ For containerized Flask backends, ensure:
 
 - runner.py expects frontend project in frontend and Python app in backend/app.py.
 - If those paths do not exist, Dev Linker skips launch and only tries to detect already-running services.
+- If frontend is missing but backend is available, DevLinker continues in backend-only mode.
 - Tunnel selection order is: cloudflared (TryCloudflare), then ngrok.
 - If cloudflared is unavailable and ngrok is not configured, Dev Linker prints one-time setup guidance.
 - You may need to set ngrok auth once on your machine using ngrok config add-authtoken <token>.
 - Dev Linker prints a public URL with `ngrok-skip-browser-warning=true` only when ngrok is used.
 - Startup output includes selected tunnel provider (`cloudflare` or `ngrok`).
 - Proxy layer now supports WebSocket upgrades, including Vite HMR over shared links.
+- Proxy handles common CORS/preflight behavior and adds camera/mic permissions policy headers.
+- Live API request logging is disabled by default and only enabled with `devlinker --debug`.
 - Proxy listens on `0.0.0.0` and can print a WLAN URL for same-network sharing.
 - If WLAN access fails on Windows, allow the proxy port in firewall and confirm devices are on the same network.
 

{devlinker-1.3.8 → devlinker-1.4.1}/README.md

@@ -1,12 +1,16 @@
 # Dev Linker
 
-Dev Linker runs frontend and backend dev servers, proxies both through a single local port (8000), and creates a single public URL via Cloudflare or ngrok.
+Dev Linker starts your local development stack and routes frontend and backend traffic through one proxy URL, with optional LAN and public sharing.
 
 
 ## Features
 
 - 🚀 **Unified Dev Proxy:** Combines frontend (Vite/React) and backend (FastAPI/Flask/Node/Docker) into a single local and public URL.
 - 🔍 **Auto Detection:** Detects frontend/backend ports, runtime, Docker containers, and Vite servers automatically.
+- 📡 **Debug Request Logger:** Live API traffic lines (method, path, status, latency) only in debug mode.
+- 🧩 **Backend-Only Mode:** If no frontend is detected, DevLinker still runs and forwards all traffic to backend.
+- 🔁 **Auto API URL Sync:** Updates `frontend/.env.local` with `VITE_API_URL=http://localhost:<proxy-port>` using a managed block.
+- 🛡️ **Proxy CORS + Preflight:** Handles common CORS/preflight behavior at the proxy layer, including credential-safe Origin handling.
 - 🧠 **Smart Detection & Doctor:** Real-time request analysis, backend intelligence, log analyzer, and `devlinker doctor` for instant diagnostics.
 - 🛡️ **Auto-Fix Engine:** `devlinker fix` applies safe fixes (like VITE_API_URL) and suggests code changes.
 - 🌍 **Public Sharing:** Share your local dev environment instantly with `--url` (startup) or `devlinker share` (runtime, no restart).
@@ -17,9 +21,21 @@ Dev Linker runs frontend and backend dev servers, proxies both through a single
 - 🧪 **Runtime Smoke Test:** Built-in test for end-to-end proxy validation.
 - 🛠️ **Extensible:** Modular architecture for future SaaS, dashboard, and team features.
 
+## Support DevLinker
+
+If DevLinker helps you ship faster, consider supporting the project:
+
+> 💖 Support DevLinker
+> [![UPI](https://img.shields.io/badge/UPI-devlinker%40upi-22c55e?style=for-the-badge)](upi://pay?pa=devlinker@upi&pn=DevLinker&cu=INR&tn=Support%20DevLinker%20Project%20🚀)
+> [![Donate](https://img.shields.io/badge/Support-Scan%20or%20Pay-0ea5e9?style=for-the-badge)](upi://pay?pa=devlinker@upi&pn=DevLinker&cu=INR&tn=Support%20DevLinker%20Project%20🚀)
+
+- 💖 UPI: devlinker@upi
+- 🔗 UPI link: upi://pay?pa=devlinker@upi&pn=DevLinker&cu=INR&tn=Support%20DevLinker%20Project%20🚀
+
 ## CLI Commands & Options
 
 - `devlinker` — Start proxy (local only, fast)
+- `devlinker support` — Show UPI support QR code in terminal
 - `devlinker --url` — Start with public tunnel (Cloudflare/ngrok)
 - `devlinker share` — Enable public tunnel at runtime (no restart)
 - `devlinker unshare` — Disable public tunnel at runtime
@@ -31,6 +47,7 @@ Dev Linker runs frontend and backend dev servers, proxies both through a single
 - `devlinker --no-lan` — Hide WLAN sharing URL
 - `devlinker --interactive-backend` — Prompt to choose backend if multiple found
 - `devlinker --proxy-port 18000` — Use custom proxy port
+- `devlinker --debug` — Enable debug mode (turns on live API request logger)
 - `devlinker --version` — Show version
 
 ## Project Structure
@@ -57,6 +74,12 @@ For local development:
 pip install .
 ```
 
+For editable local development:
+
+```bash
+pip install -e .
+```
+
 After publishing to PyPI:
 
 ```bash
@@ -69,34 +92,47 @@ pip install devlinker
 devlinker
 ```
 
-Typical startup output:
+Direct module run (without installing entrypoint script):
+
+```bash
+python -m devlinker.main
+```
+
+Typical startup output (TTY with Rich available):
 
 ```text
-Dev Linker v1.2.2
-
-[INFO] Mode: Auto (FastAPI async proxy + Docker detection)
-[INFO] Booting local services...
-[INFO] Detecting frontend/backend ports...
-[OK] Frontend -> 5173
-[OK] Backend  -> 5000
-
-[OK] Proxy ready at http://localhost:8000
-
-[OK] Tunnel provider: Cloudflare
-[OK] Public URL:
-    https://xxxx.trycloudflare.com
-Tip: Press Ctrl+Click to open link
-
-[INFO] Share this link with collaborators.
-
-DevLinker Ready (in 2.4s)
-Frontend: http://localhost:5173
-Backend:  http://localhost:5000
-Access Links:
-Local:  http://localhost:8000
-WLAN:   http://192.168.1.5:8000
-Public: https://xxxx.trycloudflare.com
-Tip: Press Ctrl+Click to open link
+╭─────────────────────────────╮
+│ ♾️  DevLinker v1.4.1        │
+│ Smart Local Dev Environment │
+╰─────────────────────────────╯
+
+✔ Detecting project...
+⏳ Booting local services...
+
+╭───────── DevLinker Ready ─────────╮
+│ Proxy     http://localhost:8001   │
+│ WLAN      http://192.168.1.3:8001 │
+│ Public    disabled (use --url)    │
+╰───────────────────────────────────╯
+
+✨ Ready in 5.5s
+Powered by DevLinker 🚀
+```
+
+Enable debug mode with live API request logging:
+
+```bash
+devlinker --debug
+```
+
+Debug mode request logger sample:
+
+```text
+🛠 Debug mode enabled: live API request logger is ON
+
+📡 Requests (Live)
+GET    /api/users               200  45ms
+POST   /api/login               401  120ms
 ```
 
 Version check:
@@ -129,15 +165,6 @@ devlinker --docker
 By default, DevLinker starts **fast local proxy only** (no tunnel). To enable a public tunnel, use the `--url` flag:
 
 
-```bash
-devlinker --url
-```
-
-In your terminal output, you'll see:
-
-
-URL, run:
-
 ```bash
 devlinker --url
 ```
@@ -146,11 +173,11 @@ This will start the proxy and open a public tunnel (Cloudflare or ngrok). The ou
 
 ```text
 🌍 Enabling public tunnel...
-[OK] Tunnel provider: Cloudflare
-[OK] Public URL:
+✔ Tunnel provider: Cloudflare
+✔ Public URL:
      https://xxxx.trycloudflare.com
-Tip: Press Ctrl+Click to open link
-[INFO] Share this link with collaborators.
+ℹ Tip: Ctrl+Click to open link
+ℹ Share this link with collaborators.
 ```
 
 To force tunnel off (even if --url is passed):
@@ -210,13 +237,11 @@ devlinker --frontend 5173 --backend 5000 --proxy-port 18000
 Default behavior also tries fallback ports automatically when 8000 is busy:
 
 ```text
-[WARN] Port 8000 in use
-[INFO] Using proxy port: 8001
+⚠ Port 8000 in use
+ℹ Using proxy port: 8001
 ```
 
-- 8001
-- 8002
-- 18000
+By default it scans the next 10 ports after the requested one, then tries `18000`.
 
 Frontend detection behavior:
 
@@ -235,6 +260,41 @@ fetch("/api/endpoint")
 
 Do not hardcode backend host URLs in frontend code.
 
+DevLinker also writes/updates a managed block in `frontend/.env.local`:
+
+```env
+# devlinker-managed:start
+VITE_API_URL=http://localhost:8001
+# devlinker-managed:end
+```
+
+This keeps frontend API calls consistently routed through the proxy.
+
+Use the proxy URL as your single entry point during development:
+
+```text
+http://localhost:<proxy-port>
+```
+
+Avoid direct backend calls like `http://localhost:5000` from browser-facing code.
+
+## Configuration File
+
+DevLinker loads config from the first file found in this order:
+
+1. `devlinker.yaml`
+2. `devlinker.yml`
+3. `devlinker.json`
+
+Example:
+
+```yaml
+frontend: 5173
+backend: 5000
+proxy_port: 8001
+tunnel: false
+```
+
 ## Backend Auto-Detection
 
 Backend port detection runs in this order:
@@ -290,12 +350,15 @@ For containerized Flask backends, ensure:
 
 - runner.py expects frontend project in frontend and Python app in backend/app.py.
 - If those paths do not exist, Dev Linker skips launch and only tries to detect already-running services.
+- If frontend is missing but backend is available, DevLinker continues in backend-only mode.
 - Tunnel selection order is: cloudflared (TryCloudflare), then ngrok.
 - If cloudflared is unavailable and ngrok is not configured, Dev Linker prints one-time setup guidance.
 - You may need to set ngrok auth once on your machine using ngrok config add-authtoken <token>.
 - Dev Linker prints a public URL with `ngrok-skip-browser-warning=true` only when ngrok is used.
 - Startup output includes selected tunnel provider (`cloudflare` or `ngrok`).
 - Proxy layer now supports WebSocket upgrades, including Vite HMR over shared links.
+- Proxy handles common CORS/preflight behavior and adds camera/mic permissions policy headers.
+- Live API request logging is disabled by default and only enabled with `devlinker --debug`.
 - Proxy listens on `0.0.0.0` and can print a WLAN URL for same-network sharing.
 - If WLAN access fails on Windows, allow the proxy port in firewall and confirm devices are on the same network.
 

devlinker-1.4.1/devlinker/config.py

@@ -0,0 +1,17 @@
+import os
+import json
+
+import yaml
+
+def load_config(config_path: str = "devlinker.yaml") -> dict:
+    candidates = [config_path, "devlinker.yml", "devlinker.json"]
+    selected = next((path for path in candidates if os.path.exists(path)), None)
+    if not selected:
+        return {}
+
+    with open(selected, "r", encoding="utf-8") as handle:
+        if selected.endswith(".json"):
+            data = json.load(handle)
+        else:
+            data = yaml.safe_load(handle)
+    return data or {}

{devlinker-1.3.8 → devlinker-1.4.1}/devlinker/detector_ai.py

@@ -1,16 +1,21 @@
 class DevLinkerAI:
     def analyze_failure(self, error_text):
+        lowered = error_text.lower()
         if "CORS" in error_text:
             return [
                 "Frontend is calling backend directly",
                 "Use /api/* instead of localhost:PORT"
             ]
         if "404" in error_text:
+            if " get / " in lowered or lowered.strip().startswith("get /"):
+                return []
+            if "/api" not in lowered:
+                return ["Route not found"]
             return [
                 "Route not found",
                 "Check if '/api' prefix is required"
             ]
-        if "connection refused" in error_text.lower():
+        if "connection refused" in lowered:
             return [
                 "Backend not reachable",
                 "Ensure backend is running"

{devlinker-1.3.8 → devlinker-1.4.1}/devlinker/devlinker_loader_instant.html

@@ -63,8 +63,22 @@
       font-size: 0.92rem;
       font-weight: 500;
       opacity: 0.9;
-      pointer-events: none;
-      user-select: none;
+      pointer-events: auto;
+      user-select: text;
+    }
+    .devlinker-powered span {
+      display: block;
+      margin-top: 4px;
+      color: #cbd5e1;
+    }
+    .devlinker-powered a {
+      color: #7dd3fc;
+      text-decoration: none;
+      font-weight: 600;
+    }
+    .devlinker-powered a:hover {
+      color: #bae6fd;
+      text-decoration: underline;
     }
     @keyframes devlinker-spin {
       to { transform: rotate(360deg); }
@@ -80,7 +94,10 @@
       <div class="devlinker-health">Frontend connected • Backend connected</div>
     </div>
   </div>
-  <div class="devlinker-powered">Powered by DevLinker</div>
+  <div class="devlinker-powered">
+    Powered by DevLinker 🚀
+    <span>Support the project ❤️ <a href="upi://pay?pa=devlinker@upi&pn=DevLinker&cu=INR&tn=Support%20DevLinker%20Project%20🚀">devlinker@upi</a></span>
+  </div>
   <script>
     // Fetch the real page and replace the loader with a short minimum display for smoothness.
     (async function() {

{devlinker-1.3.8 → devlinker-1.4.1}/devlinker/devlinker_loader_snippet.html

@@ -98,6 +98,33 @@
     font-weight: 500;
     opacity: 0.95;
   }
+  .devlinker-support {
+    color: #cbd5e1;
+    line-height: 1.45;
+  }
+  .devlinker-support a {
+    color: #7dd3fc;
+    text-decoration: none;
+    font-weight: 600;
+  }
+  .devlinker-support a:hover {
+    color: #bae6fd;
+    text-decoration: underline;
+  }
+  .devlinker-warning {
+    display: none;
+    margin-top: 12px;
+    border: 1px solid rgba(251, 191, 36, 0.45);
+    background: rgba(120, 53, 15, 0.26);
+    border-radius: 12px;
+    padding: 10px 12px;
+    color: #fde68a;
+    font-size: 0.9rem;
+    line-height: 1.4;
+  }
+  .devlinker-warning strong {
+    color: #fef3c7;
+  }
   @keyframes devlinker-spin {
     to { transform: rotate(360deg); }
   }
@@ -124,8 +151,12 @@
       <div class="devlinker-tip">Tip: Share your app instantly with one link. No CORS issues, no port confusion.</div>
       <div class="devlinker-tip">Go Pro: custom domains, faster sharing, and no branding.</div>
       <a class="devlinker-upgrade" href="https://devlinker.app" target="_blank" rel="noopener">Explore Pro at devlinker.app</a>
+      <div class="devlinker-support">Support the project ❤️ <a href="upi://pay?pa=devlinker@upi&pn=DevLinker&cu=INR&tn=Support%20DevLinker%20Project%20🚀">devlinker@upi</a></div>
+      <div class="devlinker-warning" id="devlinker-camera-warning">
+        <strong>Camera warning:</strong> camera and microphone are blocked on LAN HTTP URLs by browser policy. Use localhost or run <strong>devlinker --url</strong> for HTTPS sharing.
+      </div>
     </div>
-    <div class="devlinker-powered">Powered by DevLinker</div>
+    <div class="devlinker-powered">Powered by DevLinker 🚀</div>
   </div>
 </div>
 <script>
@@ -149,6 +180,16 @@ const MIN_TIME = 800;
 const MAX_TIME = 5000;
 let hidden = false;
 
+const cameraContext = window.__DEVLINKER_CAMERA_CONTEXT__ || {};
+const warningElement = document.getElementById("devlinker-camera-warning");
+if (warningElement) {
+  const isLan = cameraContext.mode === "lan";
+  const isSecure = Boolean(cameraContext.secure);
+  if (isLan && !isSecure) {
+    warningElement.style.display = "block";
+  }
+}
+
 function hideLoader() {
   if (hidden) return;
   hidden = true;