@grafema/types 0.1.0-alpha.1

package/dist/plugins.d.ts

@@ -0,0 +1,131 @@
+/**
+ * Plugin Types - types for analysis plugins
+ */
+import type { NodeType, NodeRecord } from './nodes.js';
+import type { EdgeType, EdgeRecord } from './edges.js';
+export declare const PLUGIN_PHASE: {
+    readonly DISCOVERY: "DISCOVERY";
+    readonly INDEXING: "INDEXING";
+    readonly ANALYSIS: "ANALYSIS";
+    readonly ENRICHMENT: "ENRICHMENT";
+    readonly VALIDATION: "VALIDATION";
+};
+export type PluginPhase = typeof PLUGIN_PHASE[keyof typeof PLUGIN_PHASE];
+export interface PluginMetadata {
+    name: string;
+    phase: PluginPhase;
+    priority?: number;
+    creates?: {
+        nodes?: NodeType[];
+        edges?: EdgeType[];
+    };
+    dependencies?: string[];
+}
+export interface PluginContext {
+    manifest?: unknown;
+    graph: GraphBackend;
+    config?: OrchestratorConfig;
+    phase?: PluginPhase;
+    projectPath?: string;
+    onProgress?: (info: Record<string, unknown>) => void;
+    forceAnalysis?: boolean;
+    workerCount?: number;
+}
+export interface PluginResult {
+    success: boolean;
+    created: {
+        nodes: number;
+        edges: number;
+    };
+    errors: Error[];
+    warnings: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface Manifest {
+    services: ManifestService[];
+    entrypoints: ManifestEntrypoint[];
+    projectPath: string;
+}
+export interface ManifestService {
+    id: string;
+    name: string;
+    path: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ManifestEntrypoint {
+    id: string;
+    name: string;
+    file: string;
+    type: string;
+    trigger?: string;
+}
+export interface OrchestratorConfig {
+    projectPath: string;
+    plugins?: string[];
+    phases?: PluginPhase[];
+    parallel?: boolean;
+    maxWorkers?: number;
+    verbose?: boolean;
+}
+export interface InputNode {
+    id: string;
+    type?: string;
+    nodeType?: string;
+    name?: string;
+    file?: string;
+    line?: number;
+    [key: string]: unknown;
+}
+export interface InputEdge {
+    src: string;
+    dst: string;
+    type: string;
+    [key: string]: unknown;
+}
+export interface GraphBackend {
+    addNode(node: InputNode): Promise<void> | void;
+    addEdge(edge: InputEdge): Promise<void> | void;
+    addNodes(nodes: InputNode[]): Promise<void> | void;
+    addEdges(edges: InputEdge[]): Promise<void> | void;
+    getNode(id: string): Promise<NodeRecord | null>;
+    queryNodes(filter: NodeFilter): AsyncIterable<NodeRecord> | AsyncGenerator<NodeRecord>;
+    getAllNodes(filter?: NodeFilter): Promise<NodeRecord[]>;
+    getOutgoingEdges(nodeId: string, edgeTypes?: EdgeType[] | null): Promise<EdgeRecord[]>;
+    getIncomingEdges(nodeId: string, edgeTypes?: EdgeType[] | null): Promise<EdgeRecord[]>;
+    nodeCount(): Promise<number>;
+    edgeCount(): Promise<number>;
+    getAllEdges?(): Promise<EdgeRecord[]>;
+    countNodesByType(types?: string[] | null): Promise<Record<string, number>>;
+    countEdgesByType(types?: string[] | null): Promise<Record<string, number>>;
+    findByType?(type: string): Promise<string[]>;
+    findByAttr?(query: Record<string, unknown>): Promise<string[]>;
+    runDatalogQuery?(query: string): Promise<unknown[]>;
+    checkGuarantee?(query: string): unknown[] | Promise<unknown[]>;
+    deleteNode?(id: string): Promise<void>;
+    deleteEdge?(src: string, dst: string, type: string): Promise<void>;
+    flush?(): Promise<void>;
+    close?(): Promise<void>;
+}
+export interface NodeFilter {
+    type?: NodeType;
+    nodeType?: NodeType;
+    name?: string;
+    file?: string;
+    [key: string]: unknown;
+}
+export interface IPlugin {
+    config: Record<string, unknown>;
+    metadata: PluginMetadata;
+    initialize?(context: PluginContext): Promise<void>;
+    execute(context: PluginContext): Promise<PluginResult>;
+    cleanup?(): Promise<void>;
+}
+export declare function createSuccessResult(created?: {
+    nodes: number;
+    edges: number;
+}, metadata?: Record<string, unknown>): PluginResult;
+export declare function createErrorResult(error: Error, created?: {
+    nodes: number;
+    edges: number;
+}): PluginResult;
+//# sourceMappingURL=plugins.d.ts.map

package/dist/plugins.d.ts.map

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

package/dist/plugins.js

@@ -0,0 +1,30 @@
+/**
+ * Plugin Types - types for analysis plugins
+ */
+// === PLUGIN PHASES ===
+export const PLUGIN_PHASE = {
+    DISCOVERY: 'DISCOVERY',
+    INDEXING: 'INDEXING',
+    ANALYSIS: 'ANALYSIS',
+    ENRICHMENT: 'ENRICHMENT',
+    VALIDATION: 'VALIDATION',
+};
+// === HELPER FUNCTIONS ===
+export function createSuccessResult(created = { nodes: 0, edges: 0 }, metadata = {}) {
+    return {
+        success: true,
+        created,
+        errors: [],
+        warnings: [],
+        metadata,
+    };
+}
+export function createErrorResult(error, created = { nodes: 0, edges: 0 }) {
+    return {
+        success: false,
+        created,
+        errors: [error],
+        warnings: [],
+        metadata: {},
+    };
+}

package/dist/rfdb.d.ts

@@ -0,0 +1,183 @@
+/**
+ * RFDB Protocol Types - types for RFDB client-server protocol
+ */
+import type { NodeType } from './nodes.js';
+import type { EdgeType } from './edges.js';
+export type RFDBCommand = 'addNodes' | 'addEdges' | 'deleteNode' | 'deleteEdge' | 'clear' | 'updateNodeVersion' | 'getNode' | 'nodeExists' | 'findByType' | 'findByAttr' | 'queryNodes' | 'getAllNodes' | 'getAllEdges' | 'isEndpoint' | 'getNodeIdentifier' | 'neighbors' | 'bfs' | 'dfs' | 'getOutgoingEdges' | 'getIncomingEdges' | 'nodeCount' | 'edgeCount' | 'countNodesByType' | 'countEdgesByType' | 'flush' | 'compact' | 'ping' | 'shutdown' | 'datalogLoadRules' | 'datalogClearRules' | 'datalogQuery' | 'checkGuarantee';
+export interface WireNode {
+    id: string;
+    nodeType: NodeType;
+    name: string;
+    file: string;
+    exported: boolean;
+    metadata: string;
+}
+export interface WireEdge {
+    src: string;
+    dst: string;
+    edgeType: EdgeType;
+    metadata: string;
+}
+export interface RFDBRequest {
+    cmd: RFDBCommand;
+    [key: string]: unknown;
+}
+export interface AddNodesRequest extends RFDBRequest {
+    cmd: 'addNodes';
+    nodes: WireNode[];
+}
+export interface AddEdgesRequest extends RFDBRequest {
+    cmd: 'addEdges';
+    edges: WireEdge[];
+    skipValidation?: boolean;
+}
+export interface DeleteNodeRequest extends RFDBRequest {
+    cmd: 'deleteNode';
+    id: string;
+}
+export interface DeleteEdgeRequest extends RFDBRequest {
+    cmd: 'deleteEdge';
+    src: string;
+    dst: string;
+    edgeType: EdgeType;
+}
+export interface GetNodeRequest extends RFDBRequest {
+    cmd: 'getNode';
+    id: string;
+}
+export interface NodeExistsRequest extends RFDBRequest {
+    cmd: 'nodeExists';
+    id: string;
+}
+export interface FindByTypeRequest extends RFDBRequest {
+    cmd: 'findByType';
+    nodeType: NodeType;
+}
+export interface FindByAttrRequest extends RFDBRequest {
+    cmd: 'findByAttr';
+    query: Record<string, unknown>;
+}
+export interface NeighborsRequest extends RFDBRequest {
+    cmd: 'neighbors';
+    id: string;
+    edgeTypes?: EdgeType[];
+}
+export interface BfsRequest extends RFDBRequest {
+    cmd: 'bfs';
+    startIds: string[];
+    maxDepth: number;
+    edgeTypes?: EdgeType[];
+}
+export interface GetOutgoingEdgesRequest extends RFDBRequest {
+    cmd: 'getOutgoingEdges';
+    id: string;
+    edgeTypes?: EdgeType[] | null;
+}
+export interface GetIncomingEdgesRequest extends RFDBRequest {
+    cmd: 'getIncomingEdges';
+    id: string;
+    edgeTypes?: EdgeType[] | null;
+}
+export interface CountNodesByTypeRequest extends RFDBRequest {
+    cmd: 'countNodesByType';
+    types?: NodeType[] | null;
+}
+export interface CountEdgesByTypeRequest extends RFDBRequest {
+    cmd: 'countEdgesByType';
+    edgeTypes?: EdgeType[] | null;
+}
+export interface RFDBResponse {
+    error?: string;
+    [key: string]: unknown;
+}
+export interface AddNodesResponse extends RFDBResponse {
+    count?: number;
+}
+export interface AddEdgesResponse extends RFDBResponse {
+    count?: number;
+}
+export interface GetNodeResponse extends RFDBResponse {
+    node?: WireNode | null;
+}
+export interface NodeExistsResponse extends RFDBResponse {
+    value: boolean;
+}
+export interface FindByTypeResponse extends RFDBResponse {
+    ids: string[];
+}
+export interface FindByAttrResponse extends RFDBResponse {
+    ids: string[];
+}
+export interface NeighborsResponse extends RFDBResponse {
+    ids: string[];
+}
+export interface BfsResponse extends RFDBResponse {
+    ids: string[];
+}
+export interface GetEdgesResponse extends RFDBResponse {
+    edges: WireEdge[];
+}
+export interface CountResponse extends RFDBResponse {
+    count: number;
+}
+export interface CountsByTypeResponse extends RFDBResponse {
+    counts: Record<string, number>;
+}
+export interface PingResponse extends RFDBResponse {
+    pong: boolean;
+    version: string;
+}
+export interface AttrQuery {
+    nodeType?: string;
+    type?: string;
+    kind?: string;
+    name?: string;
+    file?: string;
+    exported?: boolean;
+    version?: string;
+}
+export interface DatalogBinding {
+    [key: string]: string;
+}
+export interface DatalogResult {
+    bindings: DatalogBinding;
+}
+export interface IRFDBClient {
+    readonly socketPath: string;
+    readonly connected: boolean;
+    connect(): Promise<void>;
+    close(): Promise<void>;
+    ping(): Promise<string | false>;
+    shutdown(): Promise<void>;
+    addNodes(nodes: WireNode[]): Promise<AddNodesResponse>;
+    addEdges(edges: WireEdge[], skipValidation?: boolean): Promise<AddEdgesResponse>;
+    deleteNode(id: string): Promise<RFDBResponse>;
+    deleteEdge(src: string, dst: string, edgeType: EdgeType): Promise<RFDBResponse>;
+    clear(): Promise<RFDBResponse>;
+    updateNodeVersion(id: string, version: string): Promise<RFDBResponse>;
+    getNode(id: string): Promise<WireNode | null>;
+    nodeExists(id: string): Promise<boolean>;
+    findByType(nodeType: NodeType): Promise<string[]>;
+    findByAttr(query: Record<string, unknown>): Promise<string[]>;
+    queryNodes(query: AttrQuery): AsyncGenerator<WireNode, void, unknown>;
+    getAllNodes(query?: AttrQuery): Promise<WireNode[]>;
+    getAllEdges(): Promise<WireEdge[]>;
+    isEndpoint(id: string): Promise<boolean>;
+    getNodeIdentifier(id: string): Promise<string | null>;
+    neighbors(id: string, edgeTypes?: EdgeType[]): Promise<string[]>;
+    bfs(startIds: string[], maxDepth: number, edgeTypes?: EdgeType[]): Promise<string[]>;
+    dfs(startIds: string[], maxDepth: number, edgeTypes?: EdgeType[]): Promise<string[]>;
+    getOutgoingEdges(id: string, edgeTypes?: EdgeType[] | null): Promise<WireEdge[]>;
+    getIncomingEdges(id: string, edgeTypes?: EdgeType[] | null): Promise<WireEdge[]>;
+    nodeCount(): Promise<number>;
+    edgeCount(): Promise<number>;
+    countNodesByType(types?: NodeType[] | null): Promise<Record<string, number>>;
+    countEdgesByType(edgeTypes?: EdgeType[] | null): Promise<Record<string, number>>;
+    flush(): Promise<RFDBResponse>;
+    compact(): Promise<RFDBResponse>;
+    datalogLoadRules(source: string): Promise<number>;
+    datalogClearRules(): Promise<RFDBResponse>;
+    datalogQuery(query: string): Promise<DatalogResult[]>;
+    checkGuarantee(ruleSource: string): Promise<DatalogResult[]>;
+}
+//# sourceMappingURL=rfdb.d.ts.map

package/dist/rfdb.d.ts.map

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

package/dist/rfdb.js

@@ -0,0 +1,4 @@
+/**
+ * RFDB Protocol Types - types for RFDB client-server protocol
+ */
+export {};

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@grafema/types",
+  "version": "0.1.0-alpha.1",
+  "description": "Type definitions for Grafema code analysis toolkit",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "grafema",
+    "types",
+    "code-analysis",
+    "typescript"
+  ],
+  "license": "Apache-2.0",
+  "author": "Vadim Reshetnikov",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Disentinel/grafema.git",
+    "directory": "packages/types"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3"
+  }
+}

package/src/edges.ts

@@ -0,0 +1,111 @@
+/**
+ * Edge Types - graph edge type definitions
+ */
+
+// === EDGE TYPES ===
+export const EDGE_TYPE = {
+  // Structure
+  CONTAINS: 'CONTAINS',
+  DEPENDS_ON: 'DEPENDS_ON',
+  HAS_SCOPE: 'HAS_SCOPE',
+
+  // Calls
+  CALLS: 'CALLS',
+  HAS_CALLBACK: 'HAS_CALLBACK',
+  PASSES_ARGUMENT: 'PASSES_ARGUMENT',
+  RECEIVES_ARGUMENT: 'RECEIVES_ARGUMENT',
+  RETURNS: 'RETURNS',
+
+  // Inheritance
+  EXTENDS: 'EXTENDS',
+  IMPLEMENTS: 'IMPLEMENTS',
+  INSTANCE_OF: 'INSTANCE_OF',
+
+  // Imports/Exports
+  IMPORTS: 'IMPORTS',
+  EXPORTS: 'EXPORTS',
+  IMPORTS_FROM: 'IMPORTS_FROM',
+  EXPORTS_TO: 'EXPORTS_TO',
+
+  // Variables/Data flow
+  DEFINES: 'DEFINES',
+  USES: 'USES',
+  DECLARES: 'DECLARES',
+  MODIFIES: 'MODIFIES',
+  CAPTURES: 'CAPTURES',
+  ASSIGNED_FROM: 'ASSIGNED_FROM',
+  READS_FROM: 'READS_FROM',
+  WRITES_TO: 'WRITES_TO',
+
+  // HTTP/Routing
+  ROUTES_TO: 'ROUTES_TO',
+  HANDLED_BY: 'HANDLED_BY',
+  MAKES_REQUEST: 'MAKES_REQUEST',
+  MOUNTS: 'MOUNTS',
+  EXPOSES: 'EXPOSES',
+
+  // Events/Sockets
+  LISTENS_TO: 'LISTENS_TO',
+  EMITS_EVENT: 'EMITS_EVENT',
+  JOINS_ROOM: 'JOINS_ROOM',
+
+  // External
+  CALLS_API: 'CALLS_API',
+  INTERACTS_WITH: 'INTERACTS_WITH',
+
+  // Views
+  REGISTERS_VIEW: 'REGISTERS_VIEW',
+
+  // Errors
+  THROWS: 'THROWS',
+
+  // Guarantees/Invariants
+  GOVERNS: 'GOVERNS',
+  VIOLATES: 'VIOLATES',
+
+  // Unknown/fallback
+  UNKNOWN: 'UNKNOWN',
+} as const;
+
+export type EdgeType = typeof EDGE_TYPE[keyof typeof EDGE_TYPE] | string;
+
+// === EDGE RECORD ===
+export interface EdgeRecord {
+  src: string;
+  dst: string;
+  type: EdgeType;
+  index?: number;
+  metadata?: Record<string, unknown>;
+}
+
+// Semantic edge types for better type inference
+export interface ContainsEdge extends EdgeRecord {
+  type: 'CONTAINS';
+}
+
+export interface CallsEdge extends EdgeRecord {
+  type: 'CALLS';
+  argumentCount?: number;
+}
+
+export interface ImportsEdge extends EdgeRecord {
+  type: 'IMPORTS';
+  specifier?: string;
+  isDefault?: boolean;
+}
+
+export interface ExportsEdge extends EdgeRecord {
+  type: 'EXPORTS';
+  exportedName?: string;
+}
+
+export interface DataFlowEdge extends EdgeRecord {
+  type: 'ASSIGNED_FROM' | 'READS_FROM' | 'WRITES_TO' | 'PASSES_ARGUMENT';
+  dataType?: string;
+}
+
+export interface RouteEdge extends EdgeRecord {
+  type: 'ROUTES_TO' | 'HANDLED_BY';
+  method?: string;
+  path?: string;
+}

package/src/index.ts

@@ -0,0 +1,15 @@
+/**
+ * @grafema/types - Type definitions for GraphDD code analysis toolkit
+ */
+
+// Node types
+export * from './nodes.js';
+
+// Edge types
+export * from './edges.js';
+
+// Plugin types
+export * from './plugins.js';
+
+// RFDB protocol types
+export * from './rfdb.js';