@typerighter/rpc-server 0.0.0

package/.env

@@ -0,0 +1 @@
+DEV=true

package/.env.publish

@@ -0,0 +1 @@
+DEV=false

package/index.d.ts

@@ -0,0 +1,30 @@
+import { EventEmitter } from 'node:events';
+
+export interface RpcServerOptions {
+  /** Project root (default: cwd) */
+  root?: string;
+  /** Bind address (default: "127.0.0.1") */
+  addr?: string;
+  /** Bind port (default: 4747) */
+  port?: number;
+}
+
+export class RpcServer extends EventEmitter {
+  constructor(options?: RpcServerOptions);
+
+  /** The ws:// address the server is listening on, or null if not started */
+  get address(): string | null;
+
+  /** Whether the server is currently listening */
+  get listening(): boolean;
+
+  /** Start the server. Emits "listening" when ready */
+  listen(callback?: () => void): this;
+
+  /** Stop the server. Emits "close" when the process exits */
+  close(): this;
+
+  on(event: 'listening', listener: () => void): this;
+  on(event: 'close', listener: (code: number | null, signal: string | null) => void): this;
+  on(event: 'error', listener: (error: Error) => void): this;
+}

package/index.js

@@ -0,0 +1,86 @@
+import { existsSync } from "node:fs";
+import { spawn } from "node:child_process";
+import { EventEmitter } from "node:events";
+import { binPath } from "./platform.js";
+
+const bin = binPath();
+
+if (!existsSync(bin)) {
+  throw new Error(
+    `tdr-rpc binary not found at ${bin}. Run "pnpm install" to download it, ` +
+      `or build manually with "cargo build --release -p tdr-server".`,
+  );
+}
+
+const DEFAULT_PORT = 4747;
+
+export class RpcServer extends EventEmitter {
+  constructor({ root, addr, port } = {}) {
+    super();
+    this._root = root ?? process.cwd();
+    this._addr = addr ?? "127.0.0.1";
+    this._port = port ?? DEFAULT_PORT;
+    this._process = null;
+    this._listening = false;
+  }
+
+  get address() {
+    if (!this._listening) return null;
+    return `ws://${this._addr}:${this._port}`;
+  }
+
+  get listening() {
+    return this._listening;
+  }
+
+  listen(callback) {
+    if (this._process) {
+      throw new Error("Server is already running");
+    }
+
+    const child = spawn(bin, [], {
+      cwd: this._root,
+      env: {
+        ...process.env,
+        TDR_RPC_ROOT: this._root,
+        TDR_RPC_ADDR: this._addr,
+        TDR_RPC_PORT: String(this._port),
+      },
+      stdio: ["ignore", "pipe", "inherit"],
+    });
+
+    this._process = child;
+
+    const stdout = child.stdout;
+    if (!stdout) {
+      this.emit("error", new Error("Failed to capture tdr-rpc stdout"));
+      return this;
+    }
+
+    // The server prints the ws:// address when ready
+    stdout.once("data", () => {
+      this._listening = true;
+      this.emit("listening");
+      if (callback) callback();
+    });
+
+    child.on("error", (error) => {
+      this.emit("error", error);
+    });
+
+    child.on("exit", (code, signal) => {
+      this._listening = false;
+      this._process = null;
+      this.emit("close", code, signal);
+    });
+
+    return this;
+  }
+
+  close() {
+    if (this._process) {
+      this._process.kill();
+    }
+    return this;
+  }
+}

package/install.js

@@ -0,0 +1,60 @@
+import { execFileSync } from "node:child_process";
+import { existsSync, mkdirSync, chmodSync } from "node:fs";
+import path from "node:path";
+import {
+  dev,
+  osArch,
+  releaseTag,
+  artifactName,
+  artifactUrl,
+  binPath,
+  repoRoot,
+} from "./platform.js";
+
+const bin = binPath();
+
+if (existsSync(bin)) {
+  process.exit(0);
+}
+
+// In dev mode, we compile and `bin` will just automatically point to the artifact
+if (dev()) {
+  console.log("[rpc-server] Development mode: building tdr-rpc with cargo");
+  try {
+    execFileSync("cargo", ["build", "-p", "tdr-server"], {
+      cwd: repoRoot(),
+      stdio: "inherit",
+    });
+  } catch {
+    console.error("[rpc-server] cargo build failed");
+    process.exit(1);
+  }
+  process.exit(0);
+}
+
+// In non dev mode, fetch the artifacts
+const arch = osArch();
+const tag = releaseTag();
+const artifact = artifactName(arch);
+const url = artifactUrl(tag, artifact);
+
+const binDir = path.dirname(bin);
+mkdirSync(binDir, { recursive: true });
+
+console.log(`[rpc-server] Downloading tdr-rpc from ${url}`);
+
+try {
+  execFileSync("curl", ["-fsSL", "-o", bin, url], { stdio: "inherit" });
+} catch {
+  console.error(`[rpc-server] Failed to download tdr-rpc from ${url}`);
+  console.error(
+    "[rpc-server] You can build it manually: cargo build --release -p tdr-server",
+  );
+  process.exit(1);
+}
+
+if (process.platform !== "win32") {
+  chmodSync(bin, 0o755);
+}
+
+console.log("[rpc-server] tdr-rpc installed successfully");

package/package.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "https://json.schemastore.org/package",
+  "name": "@typerighter/rpc-server",
+  "version": "0.0.0",
+  "description": "Typedown RPC server binary.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Huy-DNA/typedown.git",
+    "directory": "packages/rpc-server"
+  },
+  "type": "module",
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js"
+    }
+  },
+  "scripts": {
+    "postinstall": "node install.js",
+    "prepublishOnly": "cargo build --release -p tdr-server && cp .env .env.bak && cp .env.publish .env",
+    "postpublish": "mv .env.bak .env"
+  },
+  "dependencies": {
+    "dotenv": "^16.0.0"
+  },
+  "author": "Huy-DNA <huydo862003@gmail.com>",
+  "license": "AGPL-3.0-only"
+}

package/platform.js

@@ -0,0 +1,61 @@
+import { createRequire } from "node:module";
+import path from "node:path";
+import process from "node:process";
+import dotenv from "dotenv";
+
+const require = createRequire(import.meta.url);
+const pkg = require("./package.json");
+
+const env = dotenv.config({ path: new URL(".env", import.meta.url) });
+const isDev = env.parsed?.DEV === "true";
+
+export function dev() {
+  return isDev;
+}
+
+const PLATFORM_MAP = {
+  "linux-x64": "linux-x86_64",
+  "darwin-x64": "darwin-x86_64",
+  "darwin-arm64": "darwin-aarch64",
+  "win32-x64": "windows-x86_64",
+};
+
+export function osArch() {
+  const key = `${process.platform}-${process.arch}`;
+  const mapped = PLATFORM_MAP[key];
+  if (!mapped) {
+    throw new Error(
+      `Unsupported platform: ${process.platform} ${process.arch}`,
+    );
+  }
+  return mapped;
+}
+
+export function releaseTag() {
+  const version = pkg.version;
+  if (version.includes("-")) {
+    return `staging/v${version}`;
+  }
+  return `v${version}`;
+}
+
+export function artifactName(osArchStr) {
+  const ext = process.platform === "win32" ? ".exe" : "";
+  return `tdr-rpc-${pkg.version}-${osArchStr}${ext}`;
+}
+
+export function artifactUrl(tag, artifact) {
+  return `https://github.com/Huy-DNA/typedown/releases/download/${tag}/${artifact}`;
+}
+
+export function repoRoot() {
+  return path.resolve(path.dirname(import.meta.filename), "..", "..");
+}
+
+export function binPath() {
+  const ext = process.platform === "win32" ? ".exe" : "";
+  if (isDev) {
+    return path.join(repoRoot(), "target", "debug", `tdr-rpc${ext}`);
+  }
+  return path.join(path.dirname(import.meta.filename), "bin", `tdr-rpc${ext}`);
+}