HeliosDB GraphQL Package - File Index

Core Source Files (src/)

File	Lines	Purpose
`lib.rs`	177	Package entry point, metrics, exports
`config.rs`	200	Server configuration and builder pattern
`error.rs`	115	Error types and Result alias
`schema.rs`	650	Auto-generate GraphQL schema from SQL tables
`types.rs`	300	SQL to GraphQL type mapping system
`resolver.rs`	430	Query and mutation execution resolvers
`subscriptions.rs`	450	Real-time subscriptions with CDC integration
`server.rs`	230	HTTP/WebSocket server with Axum
`filters.rs`	320	Advanced filtering, sorting, pagination
`pagination.rs`	290	Cursor-based (Relay) and offset pagination
`auth.rs`	330	JWT authentication and RBAC
`middleware.rs`	285	Rate limiting, caching, logging, complexity
`introspection.rs`	390	GraphQL schema introspection
`federation.rs`	380	Apollo Federation support
TOTAL	~4,000	14 modules

Documentation Files

File	Size	Purpose
`README.md`	6.9 KB	Comprehensive usage guide
`QUICK_REFERENCE.md`	5.2 KB	Quick reference for developers
`PACKAGE_SUMMARY.md`	12.4 KB	Complete implementation summary
`FILE_INDEX.md`	This file	File structure reference

Example Files (examples/)

File	Purpose
`basic_server.rs`	Basic GraphQL server setup
`subscription_example.rs`	Real-time subscription demo

Test Files (tests/)

File	Purpose
`integration_test.rs`	Integration tests for all modules

Configuration Files

File	Purpose
`Cargo.toml`	Package dependencies and metadata

File Locations

All files use absolute paths:

Core Module Files

/home/claude/DM-Databases/HeliosDB/heliosdb-graphql/src/lib.rs
/home/claude/DM-Databases/HeliosDB/heliosdb-graphql/src/config.rs
/home/claude/DM-Databases/HeliosDB/heliosdb-graphql/src/error.rs
/home/claude/DM-Databases/HeliosDB/heliosdb-graphql/src/schema.rs
/home/claude/DM-Databases/HeliosDB/heliosdb-graphql/src/types.rs
/home/claude/DM-Databases/HeliosDB/heliosdb-graphql/src/resolver.rs
/home/claude/DM-Databases/HeliosDB/heliosdb-graphql/src/subscriptions.rs
/home/claude/DM-Databases/HeliosDB/heliosdb-graphql/src/server.rs
/home/claude/DM-Databases/HeliosDB/heliosdb-graphql/src/filters.rs
/home/claude/DM-Databases/HeliosDB/heliosdb-graphql/src/pagination.rs
/home/claude/DM-Databases/HeliosDB/heliosdb-graphql/src/auth.rs
/home/claude/DM-Databases/HeliosDB/heliosdb-graphql/src/middleware.rs
/home/claude/DM-Databases/HeliosDB/heliosdb-graphql/src/introspection.rs
/home/claude/DM-Databases/HeliosDB/heliosdb-graphql/src/federation.rs

Documentation Files

/home/claude/DM-Databases/HeliosDB/heliosdb-graphql/README.md
/home/claude/DM-Databases/HeliosDB/heliosdb-graphql/QUICK_REFERENCE.md
/home/claude/DM-Databases/HeliosDB/heliosdb-graphql/PACKAGE_SUMMARY.md
/home/claude/DM-Databases/HeliosDB/heliosdb-graphql/FILE_INDEX.md

Example Files

/home/claude/DM-Databases/HeliosDB/heliosdb-graphql/examples/basic_server.rs
/home/claude/DM-Databases/HeliosDB/heliosdb-graphql/examples/subscription_example.rs

Test Files

/home/claude/DM-Databases/HeliosDB/heliosdb-graphql/tests/integration_test.rs

Configuration

/home/claude/DM-Databases/HeliosDB/heliosdb-graphql/Cargo.toml

Module Dependency Graph

lib.rs
  ├── config.rs
  ├── error.rs
  ├── schema.rs
  │   └── types.rs
  ├── resolver.rs
  │   ├── filters.rs
  │   └── pagination.rs
  ├── subscriptions.rs
  ├── server.rs
  │   ├── resolver.rs
  │   └── subscriptions.rs
  ├── introspection.rs
  │   └── schema.rs
  ├── federation.rs
  ├── auth.rs
  └── middleware.rs
      ├── auth.rs
      └── pagination.rs

Key Components by Feature

Schema Generation

schema.rs - Main schema generator
types.rs - Type mapping system
introspection.rs - Schema introspection

Query Execution

resolver.rs - Query/mutation resolvers
filters.rs - Filter operations
pagination.rs - Pagination support

Real-time Features

subscriptions.rs - WebSocket subscriptions
Integration with heliosdb-cdc

Security

auth.rs - JWT and RBAC
middleware.rs - Rate limiting, complexity checks

Server Infrastructure

server.rs - HTTP/WebSocket server
config.rs - Configuration management

Federation

federation.rs - Apollo Federation support

Total Package Statistics

Source Files: 14
Documentation Files: 4
Example Files: 2
Test Files: 1
Total Lines of Code: ~4,000
Dependencies: 25+ external crates
Features: 8 major feature areas

Integration Points

Internal HeliosDB Packages

heliosdb-common - Common utilities
heliosdb-storage - Data storage layer
heliosdb-metadata - Schema metadata
heliosdb-compute - Query execution
heliosdb-cdc - Change data capture

External Dependencies

async-graphql - GraphQL framework
axum - HTTP server
tokio - Async runtime
serde - Serialization
jsonwebtoken - JWT authentication
governor - Rate limiting
And 20+ more…