portless 0.15.1 → 0.15.3

package/dist/index.d.ts

@@ -6,6 +6,12 @@ import * as net from 'node:net';
 interface RouteInfo {
     hostname: string;
     port: number;
+    /**
+     * Public Tailscale Serve/Funnel URL for this route, when one is active
+     * (e.g. "https://my-device.tail1234.ts.net"). Requests whose Host header
+     * matches this URL's hostname are routed to the same upstream.
+     */
+    tailscaleUrl?: string;
 }
 interface ProxyServerOptions {
     /** Called on each request to get the current route table. */
@@ -147,6 +153,25 @@ declare class RouteStore {
     removeRoute(hostname: string, ownerPid?: number): void;
 }
 
+type UserHomeOptions = {
+    platform?: NodeJS.Platform;
+    env?: NodeJS.ProcessEnv;
+    homedir?: string;
+    passwdHome?: (username: string) => string | null;
+};
+/**
+ * Resolve the home directory that owns portless state. When sudo changes the
+ * effective user to root, retain the invoking user's home so elevated proxy
+ * processes and unprivileged app processes share the same route store.
+ */
+declare function resolveUserHome(options?: UserHomeOptions): string;
+/**
+ * Open a TCP connection to a local app port, trying both loopback families
+ * instead of hardcoding IPv4. Uses Node's Happy Eyeballs implementation
+ * (`autoSelectFamily`) with a fixed address list, so no DNS lookup happens:
+ * 127.0.0.1 is attempted first and `::1` is tried when it fails (issue #320).
+ */
+declare function createLoopbackConnection(port: number): net.Socket;
 /**
  * When running under sudo, fix file ownership so the real user can
  * read/write the file later without sudo. No-op on Windows or when not
@@ -219,4 +244,4 @@ declare function getManagedHostnames(): string[];
  */
 declare function checkHostResolution(hostname: string): Promise<boolean>;
 
-export { DIR_MODE, FILE_MODE, PORTLESS_HEADER, type ProxyServer, type ProxyServerOptions, RouteConflictError, type RouteInfo, type RouteMapping, RouteStore, buildBlock, checkHostResolution, cleanHostsFile, createHttpRedirectServer, createProxyServer, escapeHtml, extractManagedBlock, fixOwnership, formatUrl, getManagedHostnames, isErrnoException, isProcessAlive, parseHostname, parseHostnames, removeBlock, shouldAutoSyncHosts, syncHostsFile };
+export { DIR_MODE, FILE_MODE, PORTLESS_HEADER, type ProxyServer, type ProxyServerOptions, RouteConflictError, type RouteInfo, type RouteMapping, RouteStore, buildBlock, checkHostResolution, cleanHostsFile, createHttpRedirectServer, createLoopbackConnection, createProxyServer, escapeHtml, extractManagedBlock, fixOwnership, formatUrl, getManagedHostnames, isErrnoException, isProcessAlive, parseHostname, parseHostnames, removeBlock, resolveUserHome, shouldAutoSyncHosts, syncHostsFile };

package/dist/index.js

@@ -8,6 +8,7 @@ import {
   checkHostResolution,
   cleanHostsFile,
   createHttpRedirectServer,
+  createLoopbackConnection,
   createProxyServer,
   escapeHtml,
   extractManagedBlock,
@@ -19,9 +20,10 @@ import {
   parseHostname,
   parseHostnames,
   removeBlock,
+  resolveUserHome,
   shouldAutoSyncHosts,
   syncHostsFile
-} from "./chunk-SD2PIWJU.js";
+} from "./chunk-JSJUKQRJ.js";
 export {
   DIR_MODE,
   FILE_MODE,
@@ -32,6 +34,7 @@ export {
   checkHostResolution,
   cleanHostsFile,
   createHttpRedirectServer,
+  createLoopbackConnection,
   createProxyServer,
   escapeHtml,
   extractManagedBlock,
@@ -43,6 +46,7 @@ export {
   parseHostname,
   parseHostnames,
   removeBlock,
+  resolveUserHome,
   shouldAutoSyncHosts,
   syncHostsFile
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "portless",
-  "version": "0.15.1",
+  "version": "0.15.3",
   "description": "Replace port numbers with stable, named .localhost URLs. For humans and agents.",
   "type": "module",
   "main": "./dist/index.js",