@typerighter/rpc-server 0.1.3 → 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

@@ -24,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;
@@ -97,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/package.json

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