| Understand the architecture and component stack |
Architecture Overview |
Use this guide when integrating deep-chat-react in a Next.js frontend against Drupal's AI chatbot module with OAuth Bearer token authentication. Use the Authentication Flow guide when you need to trace the… |
| Trace the OAuth + CSRF authentication flow step by step |
Authentication Flow |
Use this guide to understand why OAuth and CSRF must work together and to trace each request in the flow. Use CSRF Token Lifecycle to understand the internal token mechanics. |
| Understand how CSRF tokens are generated and why validation fails |
CSRF Token Lifecycle |
Use this guide to understand the internals of CsrfTokenGenerator::get() and validate(). Use Common Pitfalls for actionable fixes when validation fails. |
| Configure deep-chat-react with interceptors and SSE streaming |
DeepChat Configuration |
Use this guide to configure deep-chat-react in Next.js with the proxy pattern. Use Reference Implementation for the complete working example including the Next.js route handler. |
| Fix CSRF token errors and session context mismatches |
Common Pitfalls |
Use this guide when CSRF validation is failing (csrf_token URL query argument is invalid) or chat requests return 403. Use Debugging Checklist for systematic curl-based diagnosis. |
| Debug CSRF failures with curl and Drupal logs |
Debugging Checklist |
Use this guide when diagnosing csrf_token URL query argument is invalid or 403 errors in production. Use Common Pitfalls for known causes and fixes. |
| See a complete working Next.js proxy + Drupal controller example |
Reference Implementation |
Use this guide as the canonical working example for DeepChat + Drupal OAuth integration. Start here when building from scratch or verifying your implementation against a known-good pattern. |