// DTOs for graph visualization export interface GraphNodeDTO { id: string; // Unique identifier for the node type: 'URL' | 'COLLECTION'; label: string; // Display name/title metadata: Record; // Type-specific data (handle, url, description, etc.) } export interface GraphEdgeDTO { id: string; // Unique identifier for the edge source: string; // Source node ID target: string; // Target node ID type: 'COLLECTION_CONTAINS_URL' | 'URL_CONNECTS_URL'; metadata?: Record; // Optional edge data (connection type, added date, etc.) } export interface GraphDataDTO { nodes: GraphNodeDTO[]; edges: GraphEdgeDTO[]; totalNodeCount: number; } export interface IGraphQueryRepository { /** * Get nodes and edges for graph visualization with pagination support * Returns paginated graph data with total count for calculating pagination metadata * * @param page - Page number (1-indexed, defaults to 1) * @param limit - Number of nodes per page (defaults to 300) * @param userId - Optional user DID to scope the graph to a specific user's data */ getGraphData( page?: number, limit?: number, userId?: string, ): Promise; /** * Get a sub-graph centered around a specific URL with depth-based traversal * Returns all nodes and edges within N hops of the target URL * * @param url - Target URL to center the sub-graph around * @param depth - Number of edge hops to traverse (1-5, defaults to 1) */ getUrlSubGraph(url: string, depth: number): Promise; }