How sreeise/graph-rs-sdk works
Main Components Overview
a) Client Layer:
• GraphClient (main entry point)
• Blocking and Async clients
• Request builders and handlers
b) Authentication Layer:
• OAuth2 implementations
• Token management
• Identity platform integrations
• Interactive authentication components
c) Core Infrastructure:
• HTTP client implementation
• Request/Response handling
• Error management
• Serialization/Deserialization
d) API Implementation Layer:
• Generated API endpoints
• Resource implementations
• Method builders
Key Relationships to Highlight
Client Layer → Authentication Layer
• ↓
Core Infrastructure
• ↓
API Implementation Layer
Detailed Component Breakdown
a) Client Layer Components:
• To subcomponents:
• Request Builders
• Blocking Client
• Async Client
• Batch Request Handler
b) Authentication Components:
• OAuth2 Flow Handlers
• Authorization Code
• Client Credentials
• Device Code
• Interactive Auth
• Token Management
• Token Cache
• Refresh Handlers
• Identity Platform
• Credential Builders
• Application Builders
c) Core Infrastructure:
• HTTP Client
• Request Pipeline
• Response Handlers
• Error Handlers
• Serialization Layer
d) API Implementation:
• Resource Endpoints
• Method Builders
• Request Formatters
• Response Parsers
Special Features to Highlight
Create dedicated sections for:
• Paging Implementation
• Stream Support
• Channel Support
• Delta Query Support
• File Operations
• Upload Sessions
• Download Handlers
• Batch Operations
• OData Query Builder
Component Interactions
• API Request Flow
• Authentication Flow
• File Operation Flow
• Paging Operation Flow
Technical Details
Annotations for:
• Async/Blocking boundaries
• Error propagation paths
• Token refresh flows
• Request/Response transformation points
External Dependencies
Integration points with:
• Microsoft Graph API
• OAuth2 endpoints
• Identity Platform services
• Storage systems (for token cache)
Implementation Notes
Callouts for:
• Feature flag dependencies
• Platform-specific components
• Optional functionality
• Extension points