@grafema/util 0.3.22 → 0.3.24

package/src/storage/backends/RFDBServerBackend.ts

@@ -21,6 +21,7 @@
 import { RFDBClient, type BatchHandle } from '@grafema/rfdb-client';
 import type { ChildProcess } from 'child_process';
 import { join, dirname } from 'path';
+import { createHash } from 'crypto';
 
 import type { WireNode, WireEdge, FieldDeclaration, CommitDelta, AttrQuery as RFDBAttrQuery, DatalogExplainResult, ServerStats, CypherResult } from '@grafema/types';
 import type { NodeType, EdgeType } from '@grafema/types';
@@ -119,11 +120,21 @@ export class RFDBServerBackend {
     this.silent = options.silent ?? false;
     this._clientName = options.clientName ?? 'core';
     // Default socket path: next to the database in .grafema folder
-    // This ensures each project has its own socket, avoiding conflicts
+    // This ensures each project has its own socket, avoiding conflicts.
+    // Unix socket paths have a hard limit (SUN_LEN: 104 on macOS, 108 on Linux).
+    // If the project path is too deep, fall back to /tmp with a hash to avoid conflicts.
     if (options.socketPath) {
       this.socketPath = options.socketPath;
     } else if (this.dbPath) {
-      this.socketPath = join(dirname(this.dbPath), 'rfdb.sock');
+      const localSocket = join(dirname(this.dbPath), 'rfdb.sock');
+      const SUN_LEN = process.platform === 'darwin' ? 104 : 108;
+      if (Buffer.byteLength(localSocket) < SUN_LEN) {
+        this.socketPath = localSocket;
+      } else {
+        // Hash the project path to create a unique but short socket path
+        const hash = createHash('md5').update(dirname(this.dbPath)).digest('hex').slice(0, 12);
+        this.socketPath = join('/tmp', `grafema-${hash}.sock`);
+      }
     } else {
       this.socketPath = '/tmp/rfdb.sock'; // fallback, not recommended
     }
@@ -283,6 +294,22 @@ export class RFDBServerBackend {
     this.serverProcess = null;
   }
 
+  /**
+   * Shutdown the RFDB server gracefully (flush + exit).
+   * Use before operations that invalidate the socket (e.g. clear + restart).
+   */
+  async shutdownServer(): Promise<void> {
+    if (!this.client) return;
+    try {
+      await this.client.shutdown();
+    } catch {
+      // Server may already be gone
+    }
+    this.client = null;
+    this.connected = false;
+    this.serverProcess = null;
+  }
+
   /**
    * Clear the database
    */

package/src/utils/lazyDownload.ts

@@ -61,6 +61,10 @@ const DOWNLOADABLE_BINARIES = [
   // BEAM (Elixir/Erlang)
   'beam-analyzer',
   'beam-resolve',
+  // GUI
+  'grafema-gui',
+  // RFDB
+  'rfdb-server',
 ];
 
 /**

package/src/version.ts

@@ -26,3 +26,42 @@ export function getSchemaVersion(version: string): string {
   const base = version.split('-')[0];
   return base;
 }
+
+export interface ParsedVersion {
+  major: number;
+  minor: number;
+  patch: number;
+}
+
+/**
+ * Parse a version string into structured major.minor.patch components.
+ * Strips pre-release tags before parsing.
+ *
+ * @param version - Version string (e.g., "0.2.5-beta")
+ * @returns Parsed version or null if the string is not a valid version
+ */
+export function parseVersion(version: string): ParsedVersion | null {
+  const base = getSchemaVersion(version);
+  const parts = base.split('.');
+  if (parts.length < 2) return null;
+  const major = parseInt(parts[0], 10);
+  const minor = parseInt(parts[1], 10);
+  const patch = parts.length >= 3 ? parseInt(parts[2], 10) : 0;
+  if (isNaN(major) || isNaN(minor) || isNaN(patch)) return null;
+  return { major, minor, patch };
+}
+
+/**
+ * Check if two versions are compatible (same major.minor).
+ * Patch differences are allowed — only major or minor mismatch is incompatible.
+ *
+ * @param configVersion - Version from the config file
+ * @param currentVersion - Currently running Grafema version
+ * @returns true if versions share the same major.minor
+ */
+export function isCompatibleVersion(configVersion: string, currentVersion: string): boolean {
+  const config = parseVersion(configVersion);
+  const current = parseVersion(currentVersion);
+  if (!config || !current) return false;
+  return config.major === current.major && config.minor === current.minor;
+}