@typerighter/rpc-server 0.1.2 → 0.1.4

package/index.d.ts

@@ -5,7 +5,7 @@ export interface RpcServerOptions {
   root?: string;
   /** Bind address (default: "127.0.0.1") */
   addr?: string;
-  /** Bind port (default: 4747) */
+  /** Bind port (default: 0, OS picks a free port) */
   port?: number;
 }
 
@@ -27,6 +27,9 @@ export class RpcServer extends EventEmitter {
   /** Stop the server. Emits "close" when the process exits */
   close(): this;
 
+  /** Unref the child process so it does not prevent Node from exiting */
+  unref(): 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

@@ -4,16 +4,18 @@ import { EventEmitter } from "node:events";
 import { binPath } from "./platform.js";
 
 function resolveBin() {
-  const local = binPath();
-  if (existsSync(local)) return local;
-
-  // Fall back to system PATH
+  // Prefer user's system binary
   try {
-    return execFileSync("which", ["typedown-rpc"], { encoding: "utf-8" }).trim();
+    const system = execFileSync("which", ["typedown-rpc"], { encoding: "utf-8" }).trim();
+    if (system) return system;
   } catch {
     // ignore
   }
 
+  // Fall back to downloaded binary
+  const local = binPath();
+  if (existsSync(local)) return local;
+
   throw new Error(
     `typedown-rpc binary not found. Run "pnpm install" to download it, ` +
       `install via Nix, or build manually with "cargo build --release -p typedown-server".`,
@@ -22,14 +24,13 @@ function resolveBin() {
 
 const bin = resolveBin();
 
-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;
+    // Port 0 lets the OS pick a free port, avoiding conflicts between dev and build
+    this._port = port ?? 0;
     this._process = undefined;
     this._listening = false;
     this._resolvedAddress = undefined;
@@ -95,6 +96,14 @@ export class RpcServer extends EventEmitter {
     return this;
   }
 
+  // Unref the child process so it does not keep the Node event loop alive
+  unref() {
+    if (this._process) {
+      this._process.unref();
+    }
+    return this;
+  }
+
   close() {
     if (this._process) {
       this._process.kill();

package/install.js

@@ -13,10 +13,6 @@ import {
 
 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 typedown-rpc with cargo");

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package",
   "name": "@typerighter/rpc-server",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Typedown RPC server binary.",
   "repository": {
     "type": "git",