@hediet/dbgjs 0.1.0-next.20260915.2

package/README.md

@@ -0,0 +1,48 @@
+# 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.
+
+Commands 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%\dbgjs\service.json`; `DBGJS_SERVICE_STATE` overrides it.
+
+## Install a release build
+
+Download and extract `npm-stable-dbgjs` and `npm-stable-<platform>` from the
+Release packages workflow. Each artifact contains one tarball. Install the
+entry package and its matching native package 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`.
+Installing only the entry tarball will not supply an unpublished native
+dependency.
+
+Nightly artifacts are named `npm-nightly-dbgjs` and `npm-nightly-<platform>`.
+Their versions are `X.Y.Z-next.<YYYYMMDD>.<index>`, for example
+`0.1.0-next.20260915.2`. The date is the source CI run's UTC creation date;
+the daily index starts at 1 and retries reuse the same version. Install both
+matching nightly tarballs together. Release packages carry `publishConfig.tag`:
+`next` for nightlies and `latest` for stable packages, for the external npm
+publisher.
+
+CI itself uploads private `.tar.gz` candidates for smoke testing, not publishable
+`.tgz` releases. Only successful main builds are promoted to release artifacts.
+
+Supported platforms: Windows x64, macOS ARM64, Linux GNU x64/ARM64.
+Linux requires glibc 2.35 or newer and OpenSSL 3. Intel macOS, 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,14 @@
+export const platforms = {
+	"win32-x64": { os: "win32", 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,31 @@
+{
+  "name": "@hediet/dbgjs",
+  "version": "0.1.0-next.20260915.2",
+  "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-next.20260915.2",
+    "@hediet/dbgjs-darwin-arm64": "0.1.0-next.20260915.2",
+    "@hediet/dbgjs-linux-x64-gnu": "0.1.0-next.20260915.2",
+    "@hediet/dbgjs-linux-arm64-gnu": "0.1.0-next.20260915.2"
+  },
+  "publishConfig": {
+    "tag": "next"
+  }
+}