port-detective 1.1.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,9 +1,12 @@
 {
   "name": "port-detective",
-  "version": "1.1.0",
+  "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": {
     ".": {
@@ -14,6 +17,7 @@
   },
   "files": [
     "index.js",
+    "cli.js",
     "platform.js",
     "index.d.ts",
     "README.md",
@@ -43,11 +47,11 @@
     "access": "public"
   },
   "optionalDependencies": {
-    "port-detective-cli-win32-x64": "1.1.0",
-    "port-detective-cli-win32-arm64": "1.1.0",
-    "port-detective-cli-darwin-x64": "1.1.0",
-    "port-detective-cli-darwin-arm64": "1.1.0",
-    "port-detective-cli-linux-x64": "1.1.0",
-    "port-detective-cli-linux-arm64": "1.1.0"
+    "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"
   }
 }