portless 0.4.2 → 0.5.1

package/dist/index.d.ts

@@ -119,4 +119,40 @@ declare function formatUrl(hostname: string, proxyPort: number, tls?: boolean):
  */
 declare function parseHostname(input: string): string;
 
-export { DIR_MODE, FILE_MODE, PORTLESS_HEADER, type ProxyServer, type ProxyServerOptions, RouteConflictError, type RouteInfo, type RouteMapping, RouteStore, SYSTEM_DIR_MODE, SYSTEM_FILE_MODE, createProxyServer, escapeHtml, fixOwnership, formatUrl, isErrnoException, parseHostname };
+/**
+ * Extract the portless-managed block from /etc/hosts content.
+ * Returns the lines between the markers (exclusive), or an empty array
+ * if no managed block exists.
+ */
+declare function extractManagedBlock(content: string): string[];
+/**
+ * Remove the portless-managed block from /etc/hosts content and return
+ * the cleaned content with trailing newlines normalized.
+ */
+declare function removeBlock(content: string): string;
+/**
+ * Build a portless-managed block for the given hostnames.
+ */
+declare function buildBlock(hostnames: string[]): string;
+/**
+ * Sync /etc/hosts to include entries for all given hostnames.
+ * Replaces any existing portless-managed block. Requires root access.
+ * Returns true on success, false on failure.
+ */
+declare function syncHostsFile(hostnames: string[]): boolean;
+/**
+ * Remove the portless-managed block from /etc/hosts.
+ * Returns true on success, false on failure.
+ */
+declare function cleanHostsFile(): boolean;
+/**
+ * Return the current portless-managed hostnames from /etc/hosts.
+ */
+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.
+ */
+declare function checkLocalhostResolution(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 };

package/dist/index.js

@@ -6,13 +6,20 @@ import {
   RouteStore,
   SYSTEM_DIR_MODE,
   SYSTEM_FILE_MODE,
+  buildBlock,
+  checkLocalhostResolution,
+  cleanHostsFile,
   createProxyServer,
   escapeHtml,
+  extractManagedBlock,
   fixOwnership,
   formatUrl,
+  getManagedHostnames,
   isErrnoException,
-  parseHostname
-} from "./chunk-JMRTQAVX.js";
+  parseHostname,
+  removeBlock,
+  syncHostsFile
+} from "./chunk-P3DHZHEZ.js";
 export {
   DIR_MODE,
   FILE_MODE,
@@ -21,10 +28,17 @@ export {
   RouteStore,
   SYSTEM_DIR_MODE,
   SYSTEM_FILE_MODE,
+  buildBlock,
+  checkLocalhostResolution,
+  cleanHostsFile,
   createProxyServer,
   escapeHtml,
+  extractManagedBlock,
   fixOwnership,
   formatUrl,
+  getManagedHostnames,
   isErrnoException,
-  parseHostname
+  parseHostname,
+  removeBlock,
+  syncHostsFile
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "portless",
-  "version": "0.4.2",
+  "version": "0.5.1",
   "description": "Replace port numbers with stable, named .localhost URLs. For humans and agents.",
   "type": "module",
   "main": "./dist/index.js",
@@ -29,7 +29,7 @@
     "dev": "tsup --watch",
     "lint": "eslint src/",
     "lint:fix": "eslint src/ --fix",
-    "prepublishOnly": "pnpm build",
+    "prepublishOnly": "cp ../../README.md . && pnpm build",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
     "test:watch": "vitest",
@@ -47,7 +47,7 @@
     "type": "git",
     "url": "https://github.com/vercel-labs/portless.git"
   },
-  "homepage": "https://github.com/vercel-labs/portless#readme",
+  "homepage": "https://port1355.dev",
   "bugs": {
     "url": "https://github.com/vercel-labs/portless/issues"
   },