port-detective 1.1.0-bootstrap.0 → 1.1.1

package/README.md

@@ -5,7 +5,7 @@ TypeScript APIs. Published releases install a matching platform CLI package auto
 
 ## Install
 
-Install the package from npm when a release is available:
+Install the published package from npm:
 
 ```bash
 npm install port-detective
@@ -16,6 +16,17 @@ checkouts omit generated platform packages; build the CLI locally or set
 `PORT_DETECTIVE_BIN` when developing from this directory. `binaryPath` always overrides
 automatic resolution, and unsupported platforms can use a CLI on `PATH`.
 
+The published package also exposes the CLI command through npm:
+
+```bash
+npx --no-install port-detective check 3000
+npx --no-install port-detective scan --ports 3000,8080
+```
+
+After installation, `port-detective` is available from npm scripts and
+`node_modules/.bin`. The wrapper uses the matching bundled platform binary and falls
+back to `PORT_DETECTIVE_BIN` or a CLI on `PATH`.
+
 ## Use
 
 ```js

package/cli.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+
+"use strict";
+
+const { spawnSync } = require("node:child_process");
+const { binaryRelativePath, platformPackageName } = require("./platform");
+
+function resolveCli() {
+  if (process.env.PORT_DETECTIVE_BIN) return process.env.PORT_DETECTIVE_BIN;
+  const packageName = platformPackageName();
+  if (packageName) {
+    try {
+      return require.resolve(`${packageName}/${binaryRelativePath()}`);
+    } catch {
+      // Fall back to a separately installed CLI or PATH.
+    }
+  }
+  return process.platform === "win32" ? "port-detective.exe" : "port-detective";
+}
+
+const result = spawnSync(resolveCli(), process.argv.slice(2), {
+  stdio: "inherit",
+  windowsHide: true,
+});
+
+if (result.error) {
+  console.error(`failed to execute port-detective: ${result.error.message}`);
+  process.exit(1);
+}
+process.exit(result.status === null ? 1 : result.status);

package/package.json

@@ -1,53 +1,57 @@
-{
-  "name": "port-detective",
-  "version": "1.1.0-bootstrap.0",
-  "description": "Minimal-dependency Node.js client for the port-detective CLI.",
-  "license": "MIT",
-  "main": "index.js",
-  "types": "index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./index.d.ts",
-      "require": "./index.js",
-      "default": "./index.js"
-    }
-  },
-  "files": [
-    "index.js",
-    "platform.js",
-    "index.d.ts",
-    "README.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "test": "node --experimental-test-coverage --test-coverage-lines=45 --test-coverage-branches=65 --test-coverage-functions=55 --test"
-  },
-  "engines": {
-    "node": ">=22"
-  },
-  "keywords": [
-    "port",
-    "process",
-    "cli",
-    "networking",
-    "developer-tools"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/EquityQ/port-detective.git",
-    "directory": "npm/port-detective"
-  },
-  "homepage": "https://github.com/EquityQ/port-detective/tree/main/npm/port-detective",
-  "sideEffects": false,
-  "publishConfig": {
-    "access": "public"
-  },
-  "optionalDependencies": {
-    "port-detective-cli-win32-x64": "1.1.0-bootstrap.0",
-    "port-detective-cli-win32-arm64": "1.1.0-bootstrap.0",
-    "port-detective-cli-darwin-x64": "1.1.0-bootstrap.0",
-    "port-detective-cli-darwin-arm64": "1.1.0-bootstrap.0",
-    "port-detective-cli-linux-x64": "1.1.0-bootstrap.0",
-    "port-detective-cli-linux-arm64": "1.1.0-bootstrap.0"
-  }
-}
+{
+  "name": "port-detective",
+  "version": "1.1.1",
+  "description": "Minimal-dependency Node.js client for the port-detective CLI.",
+  "license": "MIT",
+  "main": "index.js",
+  "bin": {
+    "port-detective": "cli.js"
+  },
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "require": "./index.js",
+      "default": "./index.js"
+    }
+  },
+  "files": [
+    "index.js",
+    "cli.js",
+    "platform.js",
+    "index.d.ts",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node --experimental-test-coverage --test-coverage-lines=45 --test-coverage-branches=65 --test-coverage-functions=55 --test"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "keywords": [
+    "port",
+    "process",
+    "cli",
+    "networking",
+    "developer-tools"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/EquityQ/port-detective.git",
+    "directory": "npm/port-detective"
+  },
+  "homepage": "https://github.com/EquityQ/port-detective/tree/main/npm/port-detective",
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "optionalDependencies": {
+    "port-detective-cli-win32-x64": "1.1.1",
+    "port-detective-cli-win32-arm64": "1.1.1",
+    "port-detective-cli-darwin-x64": "1.1.1",
+    "port-detective-cli-darwin-arm64": "1.1.1",
+    "port-detective-cli-linux-x64": "1.1.1",
+    "port-detective-cli-linux-arm64": "1.1.1"
+  }
+}