@hediet/dbgjs 0.1.0

package/README.md

@@ -0,0 +1,36 @@
+# dbgjs
+
+Native JavaScript debugger CLI and TUI, distributed through npm. Requires Node.js
+22 or newer. No Rust compiler or install-time build is needed.
+
+Previously named `@hediet/jsdbg`. Commands now use `dbgjs`, environment variables
+use `DBGJS_*`, and the daemon uses a fresh `dbgjs` state location. Existing
+prototype state is left untouched. On Windows the new endpoint is
+`%LOCALAPPDATA%\hediet\dbgjs\service.json`; `DBGJS_SERVICE_STATE` overrides it.
+
+## Install a CI build
+
+Download and extract the `npm-<platform>` artifact from the CI run. It contains
+two tarballs: the entry package and its matching native package. Install both
+in the same command, for example on Windows x64:
+
+```sh
+npm install -g ./hediet-dbgjs-win32-x64-0.1.0.tgz ./hediet-dbgjs-0.1.0.tgz
+dbgjs --help
+```
+
+For a project-local installation omit `-g` and use `npx --no-install dbgjs`.
+These packages are not yet published to an npm registry; installing only the
+entry tarball will not supply an unpublished native dependency.
+
+Supported platforms: Windows x64, macOS x64/ARM64, Linux GNU x64/ARM64.
+Linux requires glibc 2.35 or newer and OpenSSL 3. Musl/Alpine and Windows ARM64
+are not supported. Platform dependencies must not be omitted.
+
+The package supplies Playwright's JavaScript library, but does not install a
+browser. Browser debugging requires a separately installed browser. `DBGJS_NODE`
+and `DBGJS_PLAYWRIGHT_PACKAGE` can override the runtime and Playwright module.
+
+Each native package keeps `dbgjs`, `dbgjs-service`, and `dbgjs-tui` together.
+Use `dbgjs service stop` for the appropriate service instance before replacing
+an installed package on Windows; running executables cannot be overwritten.

package/bin/dbgjs-tui.mjs

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { launch } from "../lib/launch.mjs";
+launch("dbgjs-tui");

package/bin/dbgjs.mjs

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import { launch } from "../lib/launch.mjs";
+launch("dbgjs");

package/lib/launch.mjs

@@ -0,0 +1,43 @@
+import { spawnSync } from "node:child_process";
+import { createRequire } from "node:module";
+import { dirname, join } from "node:path";
+import { platformKey } from "./platform.mjs";
+
+const require = createRequire(import.meta.url);
+
+export function launch(binary) {
+	try {
+		const key = platformKey(
+			process.platform,
+			process.arch,
+			process.platform === "linux" ? process.report.getReport().header.glibcVersionRuntime : undefined,
+		);
+		const packageName = `@hediet/dbgjs-${key}`;
+		let manifest;
+		try {
+			manifest = require.resolve(`${packageName}/package.json`);
+		} catch (error) {
+			if (error.code !== "MODULE_NOT_FOUND") throw error;
+			throw new Error(`Missing ${packageName}. Reinstall @hediet/dbgjs with optional dependencies enabled. For unpublished builds, install the matching platform .tgz alongside the entry-package .tgz.`, { cause: error });
+		}
+		const entryVersion = require("../package.json").version;
+		if (require(manifest).version !== entryVersion) {
+			throw new Error(`${packageName} must match @hediet/dbgjs version ${entryVersion}. Reinstall both packages together.`);
+		}
+		const executable = join(dirname(manifest), "bin", `${binary}${process.platform === "win32" ? ".exe" : ""}`);
+		const result = spawnSync(executable, process.argv.slice(2), {
+			stdio: "inherit",
+			env: {
+				...process.env,
+				DBGJS_NODE: process.env.DBGJS_NODE ?? process.execPath,
+				DBGJS_PLAYWRIGHT_PACKAGE: process.env.DBGJS_PLAYWRIGHT_PACKAGE ?? join(dirname(require.resolve("playwright/package.json")), "index.mjs"),
+			},
+		});
+		if (result.error) throw result.error;
+		if (result.signal) process.kill(process.pid, result.signal);
+		process.exit(result.status ?? 1);
+	} catch (error) {
+		console.error(`dbgjs: ${error.message}`);
+		process.exitCode = 1;
+	}
+}

package/lib/platform.mjs

@@ -0,0 +1,15 @@
+export const platforms = {
+	"win32-x64": { os: "win32", cpu: "x64" },
+	"darwin-x64": { os: "darwin", cpu: "x64" },
+	"darwin-arm64": { os: "darwin", cpu: "arm64" },
+	"linux-x64-gnu": { os: "linux", cpu: "x64", libc: "glibc" },
+	"linux-arm64-gnu": { os: "linux", cpu: "arm64", libc: "glibc" },
+};
+
+export function platformKey(os, arch, glibc) {
+	const key = `${os}-${arch}${os === "linux" ? "-gnu" : ""}`;
+	if (!platforms[key] || (os === "linux" && !glibc)) {
+		throw new Error(`Unsupported dbgjs platform: ${os}/${arch}${os === "linux" && !glibc ? " (musl)" : ""}. Supported: ${Object.keys(platforms).join(", ")}.`);
+	}
+	return key;
+}

package/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@hediet/dbgjs",
+  "version": "0.1.0",
+  "description": "Native JavaScript debugger CLI",
+  "type": "module",
+  "license": "UNLICENSED",
+  "engines": { "node": ">=22" },
+  "bin": {
+    "dbgjs": "bin/dbgjs.mjs",
+    "dbgjs-tui": "bin/dbgjs-tui.mjs"
+  },
+  "files": ["bin", "lib", "README.md"],
+  "dependencies": { "playwright": "1.62.1" },
+  "optionalDependencies": {
+    "@hediet/dbgjs-win32-x64": "0.1.0",
+    "@hediet/dbgjs-darwin-x64": "0.1.0",
+    "@hediet/dbgjs-darwin-arm64": "0.1.0",
+    "@hediet/dbgjs-linux-x64-gnu": "0.1.0",
+    "@hediet/dbgjs-linux-arm64-gnu": "0.1.0"
+  }
+}