portless 0.9.0 → 0.9.1

package/README.md

@@ -9,11 +9,19 @@ Replace port numbers with stable, named .localhost URLs for local development. F
 
 ## Install
 
+**Global (recommended):**
+
 ```bash
 npm install -g portless
 ```
 
-> Install globally. Do not add as a project dependency or run via npx.
+**Or as a project dev dependency:**
+
+```bash
+npm install -D portless
+```
+
+> portless is pre-1.0. When installed per-project, different contributors may run different versions. The state directory format may change between releases, which can require re-running `portless trust`.
 
 ## Run your app
 

package/dist/cli.js

@@ -491,7 +491,10 @@ function createSNICallback(stateDir, defaultCert, defaultKey, tld = "localhost")
 function trustCA(stateDir) {
   const caCertPath = path.join(stateDir, CA_CERT_FILE);
   if (!fileExists(caCertPath)) {
-    return { trusted: false, error: "CA certificate not found. Run with --https first." };
+    return {
+      trusted: false,
+      error: "CA certificate not found. Run portless trust to generate it."
+    };
   }
   try {
     if (process.platform === "darwin") {
@@ -735,6 +738,18 @@ function getEntryScript() {
   }
   return script;
 }
+function isLocallyInstalled() {
+  let dir = process.cwd();
+  for (; ; ) {
+    if (fs3.existsSync(path3.join(dir, "node_modules", "portless", "package.json"))) {
+      return true;
+    }
+    const parent = path3.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return false;
+}
 function collectPortlessEnvArgs() {
   const envArgs = [];
   for (const key of Object.keys(process.env)) {
@@ -1276,8 +1291,8 @@ Eliminates port conflicts, memorizing port numbers, and cookie/storage
 clashes by giving each dev server a stable .localhost URL.
 
 ${colors_default.bold("Install:")}
-  ${colors_default.cyan("npm install -g portless")}
-  Do NOT add portless as a project dependency.
+  ${colors_default.cyan("npm install -g portless")}          Global (recommended)
+  ${colors_default.cyan("npm install -D portless")}          Project dev dependency
 
 ${colors_default.bold("Usage:")}
   ${colors_default.cyan("portless proxy start")}             Start the proxy (HTTPS on port 443, daemon)
@@ -1378,11 +1393,18 @@ ${colors_default.bold("Reserved names:")}
   process.exit(0);
 }
 function printVersion() {
-  console.log("0.9.0");
+  console.log("0.9.1");
   process.exit(0);
 }
 async function handleTrust() {
   const { dir } = await discoverState();
+  if (!fs3.existsSync(dir)) {
+    fs3.mkdirSync(dir, { recursive: true });
+  }
+  const { caGenerated } = ensureCerts(dir);
+  if (caGenerated) {
+    console.log(colors_default.gray("Generated local CA certificate."));
+  }
   const result = trustCA(dir);
   if (result.trusted) {
     console.log(colors_default.green("Local CA added to system trust store."));
@@ -2032,10 +2054,11 @@ async function main() {
   const args = process.argv.slice(2);
   const isNpx = process.env.npm_command === "exec" && !process.env.npm_lifecycle_event;
   const isPnpmDlx = !!process.env.PNPM_SCRIPT_SRC_DIR && !process.env.npm_lifecycle_event;
-  if (isNpx || isPnpmDlx) {
+  if ((isNpx || isPnpmDlx) && !isLocallyInstalled()) {
     console.error(colors_default.red("Error: portless should not be run via npx or pnpm dlx."));
-    console.error(colors_default.blue("Install globally instead:"));
+    console.error(colors_default.blue("Install globally or as a project dependency:"));
     console.error(colors_default.cyan("  npm install -g portless"));
+    console.error(colors_default.cyan("  npm install -D portless"));
     process.exit(1);
   }
   if (args[0] === "--name") {

package/package.json

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