portless 0.5.2 → 0.7.0

package/dist/index.d.ts

@@ -12,6 +12,8 @@ interface ProxyServerOptions {
     getRoutes: () => RouteInfo[];
     /** The port the proxy is listening on (used to build correct URLs). */
     proxyPort: number;
+    /** TLD suffix used for hostnames (default: "localhost"). */
+    tld?: string;
     /** Optional error logger; defaults to console.error. */
     onError?: (message: string) => void;
     /** When provided, enables HTTP/2 over TLS (HTTPS). */
@@ -99,7 +101,8 @@ declare class RouteStore {
 
 /**
  * When running under sudo, fix file ownership so the real user can
- * read/write the file later without sudo. No-op when not running as root.
+ * read/write the file later without sudo. No-op on Windows or when not
+ * running as root.
  */
 declare function fixOwnership(...paths: string[]): void;
 /** Type guard for Node.js system errors with an error code. */
@@ -109,15 +112,16 @@ declare function isErrnoException(err: unknown): err is NodeJS.ErrnoException;
  */
 declare function escapeHtml(str: string): string;
 /**
- * Format a .localhost URL. Omits the port when it matches the protocol default
- * (80 for HTTP, 443 for HTTPS).
+ * Format a URL for the given hostname. Omits the port when it matches the
+ * protocol default (80 for HTTP, 443 for HTTPS).
  */
 declare function formatUrl(hostname: string, proxyPort: number, tls?: boolean): string;
 /**
- * Parse and normalize a hostname input for use as a .localhost subdomain.
- * Strips protocol prefixes, validates characters, and appends .localhost if needed.
+ * Parse and normalize a hostname input for use as a subdomain of the
+ * configured TLD. Strips protocol prefixes, validates characters, and
+ * appends the TLD suffix if needed.
  */
-declare function parseHostname(input: string): string;
+declare function parseHostname(input: string, tld?: string): string;
 
 /**
  * Extract the portless-managed block from /etc/hosts content.
@@ -150,9 +154,9 @@ declare function cleanHostsFile(): boolean;
  */
 declare function getManagedHostnames(): string[];
 /**
- * Check whether a .localhost subdomain resolves to 127.0.0.1 via the
- * system DNS resolver. Returns true if resolution works, false otherwise.
+ * Check whether a hostname resolves to 127.0.0.1 via the system DNS resolver.
+ * Returns true if resolution works, false otherwise.
  */
-declare function checkLocalhostResolution(hostname: string): Promise<boolean>;
+declare function checkHostResolution(hostname: string): Promise<boolean>;
 
-export { DIR_MODE, FILE_MODE, PORTLESS_HEADER, type ProxyServer, type ProxyServerOptions, RouteConflictError, type RouteInfo, type RouteMapping, RouteStore, SYSTEM_DIR_MODE, SYSTEM_FILE_MODE, buildBlock, checkLocalhostResolution, cleanHostsFile, createProxyServer, escapeHtml, extractManagedBlock, fixOwnership, formatUrl, getManagedHostnames, isErrnoException, parseHostname, removeBlock, syncHostsFile };
+export { DIR_MODE, FILE_MODE, PORTLESS_HEADER, type ProxyServer, type ProxyServerOptions, RouteConflictError, type RouteInfo, type RouteMapping, RouteStore, SYSTEM_DIR_MODE, SYSTEM_FILE_MODE, buildBlock, checkHostResolution, cleanHostsFile, createProxyServer, escapeHtml, extractManagedBlock, fixOwnership, formatUrl, getManagedHostnames, isErrnoException, parseHostname, removeBlock, syncHostsFile };

package/dist/index.js

@@ -7,7 +7,7 @@ import {
   SYSTEM_DIR_MODE,
   SYSTEM_FILE_MODE,
   buildBlock,
-  checkLocalhostResolution,
+  checkHostResolution,
   cleanHostsFile,
   createProxyServer,
   escapeHtml,
@@ -19,7 +19,7 @@ import {
   parseHostname,
   removeBlock,
   syncHostsFile
-} from "./chunk-P3DHZHEZ.js";
+} from "./chunk-Y6FWHU6F.js";
 export {
   DIR_MODE,
   FILE_MODE,
@@ -29,7 +29,7 @@ export {
   SYSTEM_DIR_MODE,
   SYSTEM_FILE_MODE,
   buildBlock,
-  checkLocalhostResolution,
+  checkHostResolution,
   cleanHostsFile,
   createProxyServer,
   escapeHtml,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "portless",
-  "version": "0.5.2",
+  "version": "0.7.0",
   "description": "Replace port numbers with stable, named .localhost URLs. For humans and agents.",
   "type": "module",
   "main": "./dist/index.js",
@@ -22,19 +22,9 @@
   },
   "os": [
     "darwin",
-    "linux"
+    "linux",
+    "win32"
   ],
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch",
-    "lint": "eslint src/",
-    "lint:fix": "eslint src/ --fix",
-    "prepublishOnly": "cp ../../README.md . && pnpm build",
-    "test": "vitest run",
-    "test:coverage": "vitest run --coverage",
-    "test:watch": "vitest",
-    "typecheck": "tsc --noEmit"
-  },
   "keywords": [
     "local",
     "development",
@@ -61,5 +51,15 @@
     "tsup": "^8.0.1",
     "typescript": "^5.3.3",
     "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src/",
+    "lint:fix": "eslint src/ --fix",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
   }
-}
+}