@noxlightman/winportkill 0.1.0

package/README.md

@@ -0,0 +1,50 @@
+# `@noxlightman/winportkill`
+
+Windows x64 CLI launcher for WinPortKill.
+
+## Current Behavior
+
+This package is a thin Node wrapper around the Rust binary. Published tarballs are
+expected to include `vendor/winportkill.exe`.
+
+At runtime, it resolves `winportkill.exe` in the following order:
+
+1. `WINPORTKILL_BIN`
+2. `target/debug/winportkill.exe` in the workspace
+3. `target/release/winportkill.exe` in the workspace
+4. `.vscode-extension/bin/win32-x64/winportkill.exe` in the workspace
+5. `vendor/winportkill.exe` inside this package
+
+## Local Development
+
+From the repository root:
+
+```powershell
+cargo build --release -p winportkill
+node .\packages\npm-cli\bin\winportkill.js list --json
+node .\packages\npm-cli\bin\winportkill.js who-uses 3000
+```
+
+Or from this package directory:
+
+```powershell
+npm.cmd run test:local
+npm.cmd pack
+```
+
+## Notes
+
+- Supported platform: Windows x64 only
+- The npm wrapper forwards all arguments directly to the Rust CLI
+- `npm pack` / `npm publish` runs `prepack`, which copies a release binary into `vendor/`
+- A later publishing step can replace the local binary copy with a GitHub Releases download flow
+
+## Commands
+
+```powershell
+winportkill list --json
+winportkill who-uses 3000
+winportkill kill --pid 1234
+winportkill kill --port 3000
+winportkill --serve 3000
+```

package/bin/winportkill.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+"use strict";
+
+const { spawnSync } = require("node:child_process");
+const fs = require("node:fs");
+const path = require("node:path");
+
+if (process.platform !== "win32") {
+  fail(`WinPortKill currently supports only Windows x64. Detected platform: ${process.platform}`);
+}
+
+if (process.arch !== "x64") {
+  fail(`WinPortKill currently supports only Windows x64. Detected arch: ${process.arch}`);
+}
+
+const binaryPath = resolveBinaryPath();
+const result = spawnSync(binaryPath, process.argv.slice(2), {
+  stdio: "inherit",
+  windowsHide: true
+});
+
+if (result.error) {
+  fail(`Failed to start ${binaryPath}: ${result.error.message}`);
+}
+
+if (typeof result.status === "number") {
+  process.exit(result.status);
+}
+
+fail(`WinPortKill terminated unexpectedly${result.signal ? ` with signal ${result.signal}` : ""}`);
+
+function resolveBinaryPath() {
+  const packageRoot = path.resolve(__dirname, "..");
+  const repoRoot = path.resolve(packageRoot, "..", "..");
+
+  const candidates = [
+    process.env.WINPORTKILL_BIN,
+    path.join(repoRoot, "target", "debug", "winportkill.exe"),
+    path.join(repoRoot, "target", "release", "winportkill.exe"),
+    path.join(repoRoot, ".vscode-extension", "bin", "win32-x64", "winportkill.exe"),
+    path.join(packageRoot, "vendor", "winportkill.exe")
+  ].filter(Boolean);
+
+  for (const candidate of candidates) {
+    if (isFile(candidate)) {
+      return candidate;
+    }
+  }
+
+  fail(
+    [
+      "Unable to locate winportkill.exe.",
+      "Checked:",
+      ...candidates.map((candidate) => `- ${candidate}`),
+      "Set WINPORTKILL_BIN to an explicit binary path, or build the Rust workspace first."
+    ].join("\n")
+  );
+}
+
+function isFile(filePath) {
+  try {
+    return fs.statSync(filePath).isFile();
+  } catch {
+    return false;
+  }
+}
+
+function fail(message) {
+  console.error(`[winportkill] ${message}`);
+  process.exit(1);
+}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@noxlightman/winportkill",
+  "version": "0.1.0",
+  "description": "Windows x64 CLI launcher for WinPortKill.",
+  "license": "MIT",
+  "homepage": "https://github.com/NoxLightman/winport-killer",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NoxLightman/winport-killer.git"
+  },
+  "bugs": {
+    "url": "https://github.com/NoxLightman/winport-killer/issues"
+  },
+  "bin": {
+    "winportkill": "./bin/winportkill.js"
+  },
+  "files": [
+    "bin",
+    "vendor",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "win32"
+  ],
+  "cpu": [
+    "x64"
+  ],
+  "scripts": {
+    "prepack": "node ./scripts/prepare-package.js",
+    "pretest:local": "node ./scripts/prepare-package.js",
+    "test:local": "node ./bin/winportkill.js list --json"
+  },
+  "keywords": [
+    "port",
+    "windows",
+    "process",
+    "cli",
+    "rust"
+  ]
+}