portless 0.7.1 → 0.8.0

package/README.md

@@ -29,7 +29,7 @@ portless myapp next dev
 # -> http://myapp.localhost:1355
 ```
 
-The proxy auto-starts when you run an app. A random port (4000--4999) is assigned via the `PORT` environment variable. Most frameworks (Next.js, Express, Nuxt, etc.) respect this automatically. For frameworks that ignore `PORT` (Vite, Astro, React Router, Angular), portless auto-injects `--port` and `--host` flags.
+The proxy auto-starts when you run an app. A random port (4000--4999) is assigned via the `PORT` environment variable. Most frameworks (Next.js, Express, Nuxt, etc.) respect this automatically. For frameworks that ignore `PORT` (Vite, Astro, React Router, Angular, Expo, React Native), portless auto-injects `--port` and `--host` flags.
 
 ## Use in package.json
 
@@ -53,7 +53,7 @@ portless docs.myapp next dev
 # -> http://docs.myapp.localhost:1355
 ```
 
-Wildcard subdomain routing: any subdomain of a registered route routes to that app automatically (e.g. `tenant1.myapp.localhost:1355` routes to the `myapp` app without extra registration).
+By default, only explicitly registered subdomains are routed (strict mode). Use `--wildcard` when starting the proxy to allow any subdomain of a registered route to fall back to that app (e.g. `tenant1.myapp.localhost:1355` routes to the `myapp` app without extra registration).
 
 ## Git Worktrees
 
@@ -93,10 +93,10 @@ Recommended: `.test` (IANA-reserved, no collision risk). Avoid `.local` (conflic
 
 ```mermaid
 flowchart TD
-    Browser["Browser\nmyapp.localhost:1355"]
-    Proxy["portless proxy\n(port 1355)"]
-    App1[":4123\nmyapp"]
-    App2[":4567\napi"]
+    Browser["Browser<br>myapp.localhost:1355"]
+    Proxy["portless proxy<br>(port 1355)"]
+    App1[":4123<br>myapp"]
+    App2[":4567<br>api"]
 
     Browser -->|port 1355| Proxy
     Proxy --> App1
@@ -152,6 +152,7 @@ portless proxy start             # Start the proxy (port 1355, daemon)
 portless proxy start --https     # Start with HTTP/2 + TLS
 portless proxy start -p 80       # Start on port 80 (requires sudo)
 portless proxy start --foreground  # Start in foreground (for debugging)
+portless proxy start --wildcard  # Allow unregistered subdomains to fall back to parent
 portless proxy stop              # Stop the proxy
 ```
 
@@ -165,6 +166,7 @@ portless proxy stop              # Stop the proxy
 --no-tls                         Disable HTTPS (overrides PORTLESS_HTTPS)
 --foreground                     Run proxy in foreground instead of daemon
 --tld <tld>                      Use a custom TLD instead of .localhost (e.g. test)
+--wildcard                       Allow unregistered subdomains to fall back to parent route
 --app-port <number>              Use a fixed port for the app (skip auto-assignment)
 --force                          Override a route registered by another process
 --name <name>                    Use <name> as the app name
@@ -178,6 +180,7 @@ PORTLESS_PORT=<number>           Override the default proxy port
 PORTLESS_APP_PORT=<number>       Use a fixed port for the app (same as --app-port)
 PORTLESS_HTTPS=1                 Always enable HTTPS
 PORTLESS_TLD=<tld>               Use a custom TLD (e.g. test; default: localhost)
+PORTLESS_WILDCARD=1              Allow unregistered subdomains to fall back to parent route
 PORTLESS_SYNC_HOSTS=1            Auto-sync /etc/hosts (auto-enabled for custom TLDs)
 PORTLESS_STATE_DIR=<path>        Override the state directory
 

package/dist/{chunk-AXEPQFLY.js → chunk-KKXL2CMI.js}

@@ -300,14 +300,15 @@ function buildForwardedHeaders(req, tls) {
 }
 var PORTLESS_HOPS_HEADER = "x-portless-hops";
 var MAX_PROXY_HOPS = 5;
-function findRoute(routes, host) {
-  return routes.find((r) => r.hostname === host) || routes.find((r) => host.endsWith("." + r.hostname));
+function findRoute(routes, host, strict) {
+  return routes.find((r) => r.hostname === host) || (strict ? void 0 : routes.find((r) => host.endsWith("." + r.hostname)));
 }
 function createProxyServer(options) {
   const {
     getRoutes,
     proxyPort,
     tld = "localhost",
+    strict = true,
     onError = (msg) => console.error(msg),
     tls
   } = options;
@@ -342,7 +343,7 @@ function createProxyServer(options) {
       );
       return;
     }
-    const route = findRoute(routes, host);
+    const route = findRoute(routes, host, strict);
     if (!route) {
       const safeHost = escapeHtml(host);
       const strippedHost = host.endsWith(tldSuffix) ? host.slice(0, -tldSuffix.length) : host;
@@ -436,7 +437,7 @@ function createProxyServer(options) {
     }
     const routes = getRoutes();
     const host = getRequestHost(req).split(":")[0];
-    const route = findRoute(routes, host);
+    const route = findRoute(routes, host, strict);
     if (!route) {
       socket.destroy();
       return;
@@ -515,6 +516,9 @@ function createProxyServer(options) {
     const plainServer = http.createServer(handleRequest);
     plainServer.on("upgrade", handleUpgrade);
     const wrapper = net.createServer((socket) => {
+      socket.on("error", () => {
+        socket.destroy();
+      });
       socket.once("readable", () => {
         const buf = socket.read(1);
         if (!buf) {
@@ -745,6 +749,10 @@ function isHttpsEnvEnabled() {
   const val = process.env.PORTLESS_HTTPS;
   return val === "1" || val === "true";
 }
+function isWildcardEnvEnabled() {
+  const val = process.env.PORTLESS_WILDCARD;
+  return val === "1" || val === "true";
+}
 async function discoverState() {
   if (process.env.PORTLESS_STATE_DIR) {
     const dir = process.env.PORTLESS_STATE_DIR;
@@ -894,16 +902,28 @@ function collectBinPaths(cwd) {
   return dirs;
 }
 function augmentedPath(env) {
-  const base = (env ?? process.env).PATH ?? "";
+  const source = env ?? process.env;
+  const base = source.PATH ?? source.Path ?? "";
   const bins = collectBinPaths(process.cwd());
-  return bins.length > 0 ? bins.join(path2.delimiter) + path2.delimiter + base : base;
+  const nodeBin = path2.dirname(process.execPath);
+  const allBins = [...bins, nodeBin];
+  return allBins.join(path2.delimiter) + path2.delimiter + base;
 }
 function spawnCommand(commandArgs, options) {
-  const env = { ...options?.env ?? process.env, PATH: augmentedPath(options?.env) };
-  const child = isWindows2 ? spawn(commandArgs[0], commandArgs.slice(1), {
+  const env = {
+    ...options?.env ?? process.env,
+    PATH: augmentedPath(options?.env)
+  };
+  if (isWindows2) {
+    for (const key of Object.keys(env)) {
+      if (key !== "PATH" && key.toUpperCase() === "PATH") {
+        delete env[key];
+      }
+    }
+  }
+  const child = isWindows2 ? spawn("cmd.exe", ["/d", "/s", "/c", commandArgs.join(" ")], {
     stdio: "inherit",
-    env,
-    shell: true
+    env
   }) : spawn("/bin/sh", ["-c", commandArgs.map(shellEscape).join(" ")], {
     stdio: "inherit",
     env
@@ -953,12 +973,38 @@ var FRAMEWORKS_NEEDING_PORT = {
   "react-native": { strictPort: false },
   expo: { strictPort: false }
 };
+var PACKAGE_RUNNERS = {
+  npx: [],
+  bunx: [],
+  pnpx: [],
+  yarn: ["dlx", "exec"],
+  pnpm: ["dlx", "exec"]
+};
+function findFrameworkBasename(commandArgs) {
+  if (commandArgs.length === 0) return null;
+  const first = path2.basename(commandArgs[0]);
+  if (FRAMEWORKS_NEEDING_PORT[first]) return first;
+  const subcommands = PACKAGE_RUNNERS[first];
+  if (!subcommands) return null;
+  let i = 1;
+  if (subcommands.length > 0) {
+    while (i < commandArgs.length && commandArgs[i].startsWith("-")) i++;
+    if (i >= commandArgs.length) return null;
+    if (!subcommands.includes(commandArgs[i])) {
+      const name2 = path2.basename(commandArgs[i]);
+      return FRAMEWORKS_NEEDING_PORT[name2] ? name2 : null;
+    }
+    i++;
+  }
+  while (i < commandArgs.length && commandArgs[i].startsWith("-")) i++;
+  if (i >= commandArgs.length) return null;
+  const name = path2.basename(commandArgs[i]);
+  return FRAMEWORKS_NEEDING_PORT[name] ? name : null;
+}
 function injectFrameworkFlags(commandArgs, port) {
-  const cmd = commandArgs[0];
-  if (!cmd) return;
-  const basename2 = path2.basename(cmd);
+  const basename2 = findFrameworkBasename(commandArgs);
+  if (!basename2) return;
   const framework = FRAMEWORKS_NEEDING_PORT[basename2];
-  if (!framework) return;
   if (!commandArgs.includes("--port")) {
     commandArgs.push("--port", port.toString());
     if (framework.strictPort) {
@@ -1193,6 +1239,7 @@ export {
   writeTldFile,
   getDefaultTld,
   isHttpsEnvEnabled,
+  isWildcardEnvEnabled,
   discoverState,
   findFreePort,
   isProxyRunning,