@grafema/core 0.1.0-alpha.1

package/dist/core/RFDBClient.d.ts

@@ -0,0 +1,179 @@
+/**
+ * RFDBClient - Unix socket client for RFDB server
+ *
+ * Provides the same API as GraphEngine NAPI binding but communicates
+ * with a separate rfdb-server process over Unix socket + MessagePack.
+ */
+import { EventEmitter } from 'events';
+import type { WireNode, WireEdge, RFDBResponse, IRFDBClient, AttrQuery, DatalogResult } from '@grafema/types';
+import type { NodeType, EdgeType } from '@grafema/types';
+export declare class RFDBClient extends EventEmitter implements IRFDBClient {
+    readonly socketPath: string;
+    private socket;
+    connected: boolean;
+    private pending;
+    private reqId;
+    private buffer;
+    constructor(socketPath?: string);
+    /**
+     * Connect to RFDB server
+     */
+    connect(): Promise<void>;
+    /**
+     * Handle incoming data, parse framed messages
+     */
+    private _handleData;
+    /**
+     * Handle decoded response
+     */
+    private _handleResponse;
+    /**
+     * Send a request and wait for response
+     */
+    private _send;
+    /**
+     * Add nodes to the graph
+     */
+    addNodes(nodes: Array<Partial<WireNode> & {
+        id: string;
+        type?: string;
+        node_type?: string;
+        nodeType?: string;
+    }>): Promise<RFDBResponse>;
+    /**
+     * Add edges to the graph
+     */
+    addEdges(edges: Array<Partial<WireEdge> & {
+        src: string;
+        dst: string;
+        type?: string;
+        edge_type?: string;
+        edgeType?: string;
+    }>, skipValidation?: boolean): Promise<RFDBResponse>;
+    /**
+     * Delete a node
+     */
+    deleteNode(id: string): Promise<RFDBResponse>;
+    /**
+     * Delete an edge
+     */
+    deleteEdge(src: string, dst: string, edgeType: EdgeType): Promise<RFDBResponse>;
+    /**
+     * Get a node by ID
+     */
+    getNode(id: string): Promise<WireNode | null>;
+    /**
+     * Check if node exists
+     */
+    nodeExists(id: string): Promise<boolean>;
+    /**
+     * Find nodes by type
+     */
+    findByType(nodeType: NodeType): Promise<string[]>;
+    /**
+     * Find nodes by attributes
+     */
+    findByAttr(query: Record<string, unknown>): Promise<string[]>;
+    /**
+     * Get neighbors of a node
+     */
+    neighbors(id: string, edgeTypes?: EdgeType[]): Promise<string[]>;
+    /**
+     * Breadth-first search
+     */
+    bfs(startIds: string[], maxDepth: number, edgeTypes?: EdgeType[]): Promise<string[]>;
+    /**
+     * Depth-first search
+     */
+    dfs(startIds: string[], maxDepth: number, edgeTypes?: EdgeType[]): Promise<string[]>;
+    /**
+     * Get outgoing edges from a node
+     */
+    getOutgoingEdges(id: string, edgeTypes?: EdgeType[] | null): Promise<WireEdge[]>;
+    /**
+     * Get incoming edges to a node
+     */
+    getIncomingEdges(id: string, edgeTypes?: EdgeType[] | null): Promise<WireEdge[]>;
+    /**
+     * Get node count
+     */
+    nodeCount(): Promise<number>;
+    /**
+     * Get edge count
+     */
+    edgeCount(): Promise<number>;
+    /**
+     * Count nodes by type
+     */
+    countNodesByType(types?: NodeType[] | null): Promise<Record<string, number>>;
+    /**
+     * Count edges by type
+     */
+    countEdgesByType(edgeTypes?: EdgeType[] | null): Promise<Record<string, number>>;
+    /**
+     * Flush data to disk
+     */
+    flush(): Promise<RFDBResponse>;
+    /**
+     * Compact the database
+     */
+    compact(): Promise<RFDBResponse>;
+    /**
+     * Clear the database
+     */
+    clear(): Promise<RFDBResponse>;
+    /**
+     * Query nodes (async generator)
+     */
+    queryNodes(query: AttrQuery): AsyncGenerator<WireNode, void, unknown>;
+    /**
+     * Get all nodes matching query
+     */
+    getAllNodes(query?: AttrQuery): Promise<WireNode[]>;
+    /**
+     * Get all edges
+     */
+    getAllEdges(): Promise<WireEdge[]>;
+    /**
+     * Check if node is an endpoint (has no outgoing edges)
+     */
+    isEndpoint(id: string): Promise<boolean>;
+    /**
+     * Get node identifier string
+     */
+    getNodeIdentifier(id: string): Promise<string | null>;
+    /**
+     * Update node version
+     */
+    updateNodeVersion(id: string, version: string): Promise<RFDBResponse>;
+    /**
+     * Load Datalog rules
+     */
+    datalogLoadRules(source: string): Promise<number>;
+    /**
+     * Clear Datalog rules
+     */
+    datalogClearRules(): Promise<RFDBResponse>;
+    /**
+     * Execute Datalog query
+     */
+    datalogQuery(query: string): Promise<DatalogResult[]>;
+    /**
+     * Check a guarantee (Datalog rule) and return violations
+     */
+    checkGuarantee(ruleSource: string): Promise<DatalogResult[]>;
+    /**
+     * Ping the server
+     */
+    ping(): Promise<string | false>;
+    /**
+     * Close connection
+     */
+    close(): Promise<void>;
+    /**
+     * Shutdown the server
+     */
+    shutdown(): Promise<void>;
+}
+export default RFDBClient;
+//# sourceMappingURL=RFDBClient.d.ts.map

package/dist/core/RFDBClient.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RFDBClient.d.ts","sourceRoot":"","sources":["../../src/core/RFDBClient.ts"],"names":[],"mappings":"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"}

package/dist/core/RFDBClient.js

@@ -0,0 +1,429 @@
+/**
+ * RFDBClient - Unix socket client for RFDB server
+ *
+ * Provides the same API as GraphEngine NAPI binding but communicates
+ * with a separate rfdb-server process over Unix socket + MessagePack.
+ */
+import { createConnection } from 'net';
+import { encode, decode } from '@msgpack/msgpack';
+import { EventEmitter } from 'events';
+export class RFDBClient extends EventEmitter {
+    socketPath;
+    socket;
+    connected;
+    pending;
+    reqId;
+    buffer;
+    constructor(socketPath = '/tmp/rfdb.sock') {
+        super();
+        this.socketPath = socketPath;
+        this.socket = null;
+        this.connected = false;
+        this.pending = new Map();
+        this.reqId = 0;
+        this.buffer = Buffer.alloc(0);
+    }
+    /**
+     * Connect to RFDB server
+     */
+    async connect() {
+        if (this.connected)
+            return;
+        return new Promise((resolve, reject) => {
+            this.socket = createConnection(this.socketPath);
+            this.socket.on('connect', () => {
+                this.connected = true;
+                this.emit('connected');
+                resolve();
+            });
+            this.socket.on('error', (err) => {
+                if (!this.connected) {
+                    reject(err);
+                }
+                else {
+                    this.emit('error', err);
+                }
+            });
+            this.socket.on('close', () => {
+                this.connected = false;
+                this.emit('disconnected');
+                // Reject all pending requests
+                for (const [, { reject }] of this.pending) {
+                    reject(new Error('Connection closed'));
+                }
+                this.pending.clear();
+            });
+            this.socket.on('data', (chunk) => {
+                this._handleData(chunk);
+            });
+        });
+    }
+    /**
+     * Handle incoming data, parse framed messages
+     */
+    _handleData(chunk) {
+        this.buffer = Buffer.concat([this.buffer, chunk]);
+        while (this.buffer.length >= 4) {
+            // Read length prefix (4 bytes, big-endian)
+            const msgLen = this.buffer.readUInt32BE(0);
+            if (this.buffer.length < 4 + msgLen) {
+                // Not enough data yet
+                break;
+            }
+            // Extract message
+            const msgBytes = this.buffer.subarray(4, 4 + msgLen);
+            this.buffer = this.buffer.subarray(4 + msgLen);
+            // Decode and dispatch
+            try {
+                const response = decode(msgBytes);
+                this._handleResponse(response);
+            }
+            catch (err) {
+                this.emit('error', new Error(`Failed to decode response: ${err.message}`));
+            }
+        }
+    }
+    /**
+     * Handle decoded response
+     */
+    _handleResponse(response) {
+        if (this.pending.size === 0) {
+            this.emit('error', new Error('Received response with no pending request'));
+            return;
+        }
+        // Get the oldest pending request (FIFO)
+        const [id, { resolve, reject }] = this.pending.entries().next().value;
+        this.pending.delete(id);
+        if (response.error) {
+            reject(new Error(response.error));
+        }
+        else {
+            resolve(response);
+        }
+    }
+    /**
+     * Send a request and wait for response
+     */
+    async _send(cmd, payload = {}) {
+        if (!this.connected || !this.socket) {
+            throw new Error('Not connected to RFDB server');
+        }
+        const request = { cmd, ...payload };
+        const msgBytes = encode(request);
+        return new Promise((resolve, reject) => {
+            const id = this.reqId++;
+            this.pending.set(id, { resolve, reject });
+            // Write length prefix + message
+            const header = Buffer.alloc(4);
+            header.writeUInt32BE(msgBytes.length);
+            this.socket.write(Buffer.concat([header, Buffer.from(msgBytes)]));
+        });
+    }
+    // ===========================================================================
+    // Write Operations
+    // ===========================================================================
+    /**
+     * Add nodes to the graph
+     */
+    async addNodes(nodes) {
+        const wireNodes = nodes.map(n => ({
+            id: String(n.id),
+            nodeType: (n.node_type || n.nodeType || n.type || 'UNKNOWN'),
+            name: n.name || '',
+            file: n.file || '',
+            exported: n.exported || false,
+            metadata: typeof n.metadata === 'string' ? n.metadata : JSON.stringify(n.metadata || {}),
+        }));
+        return this._send('addNodes', { nodes: wireNodes });
+    }
+    /**
+     * Add edges to the graph
+     */
+    async addEdges(edges, skipValidation = false) {
+        const wireEdges = edges.map(e => ({
+            src: String(e.src),
+            dst: String(e.dst),
+            edgeType: (e.edge_type || e.edgeType || e.type || 'UNKNOWN'),
+            metadata: typeof e.metadata === 'string' ? e.metadata : JSON.stringify(e.metadata || {}),
+        }));
+        return this._send('addEdges', { edges: wireEdges, skipValidation });
+    }
+    /**
+     * Delete a node
+     */
+    async deleteNode(id) {
+        return this._send('deleteNode', { id: String(id) });
+    }
+    /**
+     * Delete an edge
+     */
+    async deleteEdge(src, dst, edgeType) {
+        return this._send('deleteEdge', {
+            src: String(src),
+            dst: String(dst),
+            edgeType
+        });
+    }
+    // ===========================================================================
+    // Read Operations
+    // ===========================================================================
+    /**
+     * Get a node by ID
+     */
+    async getNode(id) {
+        const response = await this._send('getNode', { id: String(id) });
+        return response.node || null;
+    }
+    /**
+     * Check if node exists
+     */
+    async nodeExists(id) {
+        const response = await this._send('nodeExists', { id: String(id) });
+        return response.value;
+    }
+    /**
+     * Find nodes by type
+     */
+    async findByType(nodeType) {
+        const response = await this._send('findByType', { nodeType });
+        return response.ids || [];
+    }
+    /**
+     * Find nodes by attributes
+     */
+    async findByAttr(query) {
+        const response = await this._send('findByAttr', { query });
+        return response.ids || [];
+    }
+    // ===========================================================================
+    // Graph Traversal
+    // ===========================================================================
+    /**
+     * Get neighbors of a node
+     */
+    async neighbors(id, edgeTypes = []) {
+        const response = await this._send('neighbors', {
+            id: String(id),
+            edgeTypes
+        });
+        return response.ids || [];
+    }
+    /**
+     * Breadth-first search
+     */
+    async bfs(startIds, maxDepth, edgeTypes = []) {
+        const response = await this._send('bfs', {
+            startIds: startIds.map(String),
+            maxDepth,
+            edgeTypes
+        });
+        return response.ids || [];
+    }
+    /**
+     * Depth-first search
+     */
+    async dfs(startIds, maxDepth, edgeTypes = []) {
+        const response = await this._send('dfs', {
+            startIds: startIds.map(String),
+            maxDepth,
+            edgeTypes
+        });
+        return response.ids || [];
+    }
+    /**
+     * Get outgoing edges from a node
+     */
+    async getOutgoingEdges(id, edgeTypes = null) {
+        const response = await this._send('getOutgoingEdges', {
+            id: String(id),
+            edgeTypes
+        });
+        return response.edges || [];
+    }
+    /**
+     * Get incoming edges to a node
+     */
+    async getIncomingEdges(id, edgeTypes = null) {
+        const response = await this._send('getIncomingEdges', {
+            id: String(id),
+            edgeTypes
+        });
+        return response.edges || [];
+    }
+    // ===========================================================================
+    // Stats
+    // ===========================================================================
+    /**
+     * Get node count
+     */
+    async nodeCount() {
+        const response = await this._send('nodeCount');
+        return response.count;
+    }
+    /**
+     * Get edge count
+     */
+    async edgeCount() {
+        const response = await this._send('edgeCount');
+        return response.count;
+    }
+    /**
+     * Count nodes by type
+     */
+    async countNodesByType(types = null) {
+        const response = await this._send('countNodesByType', { types });
+        return response.counts || {};
+    }
+    /**
+     * Count edges by type
+     */
+    async countEdgesByType(edgeTypes = null) {
+        const response = await this._send('countEdgesByType', { edgeTypes });
+        return response.counts || {};
+    }
+    // ===========================================================================
+    // Control
+    // ===========================================================================
+    /**
+     * Flush data to disk
+     */
+    async flush() {
+        return this._send('flush');
+    }
+    /**
+     * Compact the database
+     */
+    async compact() {
+        return this._send('compact');
+    }
+    /**
+     * Clear the database
+     */
+    async clear() {
+        return this._send('clear');
+    }
+    // ===========================================================================
+    // Bulk Read Operations
+    // ===========================================================================
+    /**
+     * Query nodes (async generator)
+     */
+    async *queryNodes(query) {
+        const serverQuery = {};
+        if (query.nodeType)
+            serverQuery.nodeType = query.nodeType;
+        if (query.type)
+            serverQuery.nodeType = query.type;
+        if (query.name)
+            serverQuery.name = query.name;
+        if (query.file)
+            serverQuery.file = query.file;
+        if (query.exported !== undefined)
+            serverQuery.exported = query.exported;
+        const response = await this._send('queryNodes', { query: serverQuery });
+        const nodes = response.nodes || [];
+        for (const node of nodes) {
+            yield node;
+        }
+    }
+    /**
+     * Get all nodes matching query
+     */
+    async getAllNodes(query = {}) {
+        const nodes = [];
+        for await (const node of this.queryNodes(query)) {
+            nodes.push(node);
+        }
+        return nodes;
+    }
+    /**
+     * Get all edges
+     */
+    async getAllEdges() {
+        const response = await this._send('getAllEdges');
+        return response.edges || [];
+    }
+    // ===========================================================================
+    // Node Utility Methods
+    // ===========================================================================
+    /**
+     * Check if node is an endpoint (has no outgoing edges)
+     */
+    async isEndpoint(id) {
+        const response = await this._send('isEndpoint', { id: String(id) });
+        return response.value;
+    }
+    /**
+     * Get node identifier string
+     */
+    async getNodeIdentifier(id) {
+        const response = await this._send('getNodeIdentifier', { id: String(id) });
+        return response.identifier || null;
+    }
+    /**
+     * Update node version
+     */
+    async updateNodeVersion(id, version) {
+        return this._send('updateNodeVersion', { id: String(id), version });
+    }
+    // ===========================================================================
+    // Datalog API
+    // ===========================================================================
+    /**
+     * Load Datalog rules
+     */
+    async datalogLoadRules(source) {
+        const response = await this._send('datalogLoadRules', { source });
+        return response.count;
+    }
+    /**
+     * Clear Datalog rules
+     */
+    async datalogClearRules() {
+        return this._send('datalogClearRules');
+    }
+    /**
+     * Execute Datalog query
+     */
+    async datalogQuery(query) {
+        const response = await this._send('datalogQuery', { query });
+        return response.results || [];
+    }
+    /**
+     * Check a guarantee (Datalog rule) and return violations
+     */
+    async checkGuarantee(ruleSource) {
+        const response = await this._send('checkGuarantee', { ruleSource });
+        return response.violations || [];
+    }
+    /**
+     * Ping the server
+     */
+    async ping() {
+        const response = await this._send('ping');
+        return response.pong && response.version ? response.version : false;
+    }
+    /**
+     * Close connection
+     */
+    async close() {
+        if (this.socket) {
+            this.socket.destroy();
+            this.socket = null;
+            this.connected = false;
+        }
+    }
+    /**
+     * Shutdown the server
+     */
+    async shutdown() {
+        try {
+            await this._send('shutdown');
+        }
+        catch {
+            // Expected - server closes connection
+        }
+        await this.close();
+    }
+}
+export default RFDBClient;

package/dist/core/Task.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Task - базовая единица работы в очереди
+ */
+import type { TaskData, TaskType } from './TaskTypes.js';
+export type TaskStatus = 'pending' | 'running' | 'completed' | 'failed';
+export interface TaskOptions {
+    id: string;
+    type: TaskType;
+    priority?: number;
+    data: TaskData;
+    dependencies?: string[];
+}
+export declare class Task {
+    readonly id: string;
+    readonly type: TaskType;
+    readonly priority: number;
+    readonly data: TaskData;
+    readonly dependencies: string[];
+    status: TaskStatus;
+    result: unknown;
+    error: Error | null;
+    startedAt: number | null;
+    completedAt: number | null;
+    retries: number;
+    maxRetries: number;
+    constructor({ id, type, priority, data, dependencies }: TaskOptions);
+    /**
+     * Может ли задача выполняться (все зависимости готовы)
+     */
+    canExecute(completedTasks: Set<string>): boolean;
+    /**
+     * Начать выполнение
+     */
+    start(): void;
+    /**
+     * Завершить успешно
+     */
+    complete(result: unknown): void;
+    /**
+     * Завершить с ошибкой
+     */
+    fail(error: Error): void;
+    /**
+     * Можно ли повторить
+     */
+    canRetry(): boolean;
+    /**
+     * Повторить задачу
+     */
+    retry(): void;
+    /**
+     * Продолжительность выполнения (мс)
+     */
+    get duration(): number;
+}
+//# sourceMappingURL=Task.d.ts.map

package/dist/core/Task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Task.d.ts","sourceRoot":"","sources":["../../src/core/Task.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAEzD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAExE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,qBAAa,IAAI;IACf,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,CAAC;IAEhC,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;gBAEP,EAAE,EAAE,EAAE,IAAI,EAAE,QAAa,EAAE,IAAI,EAAE,YAAiB,EAAE,EAAE,WAAW;IAgB7E;;OAEG;IACH,UAAU,CAAC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO;IAIhD;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI;IAM/B;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAMxB;;OAEG;IACH,QAAQ,IAAI,OAAO;IAInB;;OAEG;IACH,KAAK,IAAI,IAAI;IAQb;;OAEG;IACH,IAAI,QAAQ,IAAI,MAAM,CAIrB;CACF"}