@grafema/rfdb 0.2.10 → 0.2.12-beta

package/README.md

@@ -39,32 +39,34 @@ rfdb-server ./my-graph.rfdb
 
 ### Programmatic usage
 
-```javascript
-const { startServer, waitForServer, isAvailable } = require('@grafema/rfdb');
+Server lifecycle is managed through `@grafema/core`:
 
-// Check if binary is available
-if (!isAvailable()) {
-  console.log('RFDB not available, using in-memory backend');
-}
+```javascript
+const { startRfdbServer, RFDBServerBackend } = require('@grafema/core');
 
-// Start server
-const server = startServer({
-  socketPath: '/tmp/rfdb.sock',
-  dataDir: './rfdb-data',
-  silent: false,
+// Start server (handles binary discovery, socket polling, PID file)
+const server = await startRfdbServer({
+  dbPath: './my-graph.rfdb',
+  socketPath: '.grafema/rfdb.sock',
 });
 
-// Wait for it to be ready
-await waitForServer('/tmp/rfdb.sock');
-
-// Use with @grafema/core
-const { RFDBServerBackend } = require('@grafema/core');
-const backend = new RFDBServerBackend({ socketPath: '/tmp/rfdb.sock' });
+// Use with Grafema
+const backend = new RFDBServerBackend({ socketPath: '.grafema/rfdb.sock' });
 
 // Stop server when done
 server.kill();
 ```
 
+This package also exports helpers for binary detection:
+
+```javascript
+const { isAvailable, waitForServer } = require('@grafema/rfdb');
+
+if (!isAvailable()) {
+  console.log('RFDB not available, using in-memory backend');
+}
+```
+
 ## With Grafema
 
 RFDB is the default storage backend for Grafema. The MCP server and CLI auto-start RFDB when needed.
@@ -74,7 +76,7 @@ const { Orchestrator, RFDBServerBackend } = require('@grafema/core');
 
 const orchestrator = new Orchestrator({
   rootDir: './src',
-  backend: new RFDBServerBackend({ socketPath: '/tmp/rfdb.sock' }),
+  backend: new RFDBServerBackend({ socketPath: '.grafema/rfdb.sock' }),
 });
 ```
 

package/index.d.ts

@@ -1,7 +1,7 @@
-import { ChildProcess } from 'child_process';
-
 /**
  * Get the path to the rfdb-server binary for the current platform.
+ * Only checks prebuilt directory. For full search, use findRfdbBinary() from @grafema/core.
+ * @deprecated Use findRfdbBinary() from @grafema/core for full binary search.
  * @returns Path to binary, or null if not available
  */
 export function getBinaryPath(): string | null;
@@ -11,21 +11,6 @@ export function getBinaryPath(): string | null;
  */
 export function isAvailable(): boolean;
 
-export interface StartServerOptions {
-  /** Unix socket path (default: /tmp/rfdb.sock) */
-  socketPath?: string;
-  /** Data directory (default: ./rfdb-data) */
-  dataDir?: string;
-  /** Suppress output (default: false) */
-  silent?: boolean;
-}
-
-/**
- * Start the rfdb-server.
- * @returns The server process
- */
-export function startServer(options?: StartServerOptions): ChildProcess & { socketPath: string };
-
 /**
  * Wait for the server to be ready.
  * @param socketPath Unix socket path

package/index.js

@@ -4,13 +4,15 @@
  * This package provides the rfdb-server binary and helpers for managing it.
  */
 
-const { spawn } = require('child_process');
 const path = require('path');
 const fs = require('fs');
 const net = require('net');
 
 /**
  * Get the path to the rfdb-server binary for the current platform.
+ * Only checks prebuilt directory. For full search (monorepo, PATH, env var, ~/.local/bin),
+ * use findRfdbBinary() from @grafema/core instead.
+ * @deprecated Use findRfdbBinary() from @grafema/core for full binary search.
  * @returns {string|null} Path to binary, or null if not available
  */
 function getBinaryPath() {
@@ -38,35 +40,6 @@ function isAvailable() {
   return getBinaryPath() !== null;
 }
 
-/**
- * Start the rfdb-server.
- * @param {Object} options
- * @param {string} options.socketPath - Unix socket path (default: /tmp/rfdb.sock)
- * @param {string} options.dataDir - Data directory (default: ./rfdb-data)
- * @param {boolean} options.silent - Suppress output (default: false)
- * @returns {ChildProcess} The server process
- */
-function startServer(options = {}) {
-  const binaryPath = getBinaryPath();
-  if (!binaryPath) {
-    throw new Error(`No rfdb-server binary available for ${process.platform}-${process.arch}`);
-  }
-
-  const socketPath = options.socketPath || '/tmp/rfdb.sock';
-  const dataDir = options.dataDir || './rfdb-data';
-
-  const args = ['--socket', socketPath, '--data-dir', dataDir];
-
-  const child = spawn(binaryPath, args, {
-    stdio: options.silent ? 'ignore' : 'inherit',
-    detached: false,
-  });
-
-  child.socketPath = socketPath;
-
-  return child;
-}
-
 /**
  * Wait for the server to be ready.
  * @param {string} socketPath - Unix socket path
@@ -102,6 +75,5 @@ function waitForServer(socketPath, timeout = 5000) {
 module.exports = {
   getBinaryPath,
   isAvailable,
-  startServer,
   waitForServer,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@grafema/rfdb",
-  "version": "0.2.10",
+  "version": "0.2.12-beta",
   "description": "RFDB (Rega Flow Database) — high-performance disk-backed graph database server for Grafema",
   "main": "index.js",
   "types": "index.d.ts",