traforo 0.3.0 → 0.4.0

package/README

@@ -111,6 +111,29 @@ instructions to pass the password as a cookie:
 WebSocket upgrade requests without the correct cookie are rejected with
 close code 4013.
 
+## TRAFORO_URL ENVIRONMENT VARIABLE
+
+When you run a command after `--`, traforo injects `TRAFORO_URL` into the
+child process environment with the full public tunnel URL:
+
+    TRAFORO_URL=https://{tunnel-id}-tunnel.traforo.dev
+
+Your app can read it directly:
+
+    const baseUrl = process.env.TRAFORO_URL
+
+To remap it to a custom env var your app already uses, prefix the command:
+
+    traforo -p 3000 -- sh -c 'APP_URL=$TRAFORO_URL exec node server.js'
+    traforo -p 3000 -- sh -c 'NEXT_PUBLIC_URL=$TRAFORO_URL exec next dev'
+    traforo -p 3000 -- sh -c 'VITE_BASE_URL=$TRAFORO_URL exec vite'
+
+Or set it in your .env / startup script and let traforo override only
+`TRAFORO_URL`, reading it where needed:
+
+    // next.config.js
+    const baseUrl = process.env.APP_URL || process.env.TRAFORO_URL || 'http://localhost:3000'
+
 ## HOW IT WORKS
 
 1. Local client connects to Cloudflare Durable Object via WebSocket

package/dist/run-tunnel.js

@@ -330,6 +330,9 @@ export async function runTunnel(options) {
         }
     }
     let child = null;
+    // Compute tunnel URL early so it can be injected into the child env
+    const baseDomain = options.baseDomain || 'traforo.dev';
+    const tunnelUrl = `https://${tunnelId}-tunnel.${baseDomain}`;
     // If command provided, spawn child process with PORT env
     if (options.command && options.command.length > 0) {
         const cmd = options.command[0];
@@ -347,6 +350,7 @@ export async function runTunnel(options) {
             env: {
                 ...process.env,
                 ...(port ? { PORT: String(port) } : {}),
+                TRAFORO_URL: tunnelUrl,
                 // Disable clear/animations for common tools without lying about CI
                 FORCE_COLOR: '1',
                 VITE_CLS: 'false',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "traforo",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "HTTP tunnel via Cloudflare Durable Objects and WebSockets. Edge caching and password protection.",
   "type": "module",
   "license": "MIT",