How crydensync/api works
Cryden API is a self-hosted HTTP wrapper for CrydenSync, backed by Postgres or (for core authentication only) SQLite. Its main user workflow is an HTTP client reaching routed authentication or account endpoints, which invoke Cryden’s auth engine and return tokens or account results. The Postgres-only admin console adds user metadata, anomaly review, logs, webhooks, digests, and AI configuration; signed-in users can also ask the AI widget questions. Unsampled handler and wiring details are represented only where the README or SOURCE INDEX documents them.
Main entry points: router.go HTTP router · main.go API server · askai.go AI query service · oauth_handlers.go OAuth flows
Components 21
Server runtime
- API server
main.go - HTTP router
httpapi/router.go - Deployment database
Identity API
- Authentication
httpapi/auth_handlers.go - Sessions
httpapi/session_handlers.go - OAuth flows
httpapi/oauth_handlers.go
Admin console
- User administration
httpapi/user_handlers.go - User metadata
httpapi/metadata_handlers.go - Anomaly review
httpapi/anomaly_handlers.go - Settings API
httpapi/settings_handlers.go - Settings storage
settings/store.go - Shipped logs
shiplog/store.go - Digest scheduling
digest/schedule.go - Webhook delivery
webhook/worker.go
AI query
- Ask AI endpoint
httpapi/widget_handlers.go - AI query service
askai/askai.go - AI providers
aiprovider/anthropic.go - Read-only SQL query
aiprovider/query.go
Other components
- HTTP client
- OAuth providers
- LLM service
Connections 22
- HTTP client → HTTP router: sends HTTP
README.md - API server → HTTP router: configures
main.go - API server → Deployment database: opens and migrates
README.md - HTTP router → Authentication: routes auth
httpapi/router.go - HTTP router → Sessions: routes sessions
httpapi/router.go - HTTP router → OAuth flows: routes OAuth
httpapi/router.go - OAuth flows → OAuth providers: exchanges identity
httpapi/oauth_handlers.go - HTTP router → User administration: routes admin
httpapi/router.go - HTTP router → User metadata: routes admin
httpapi/router.go - HTTP router → Anomaly review: routes review
httpapi/router.go - HTTP router → Settings API: routes settings
httpapi/router.go - Settings API → Settings storage: reads and writes
httpapi/settings_handlers.go - HTTP router → Shipped logs: routes log history
httpapi/router.go - API server → Digest scheduling: starts scheduler
main.go - API server → Webhook delivery: starts worker
main.go - HTTP router → Ask AI endpoint: routes widget
httpapi/router.go - Ask AI endpoint → AI query service: serves questions
- AI query service → Settings storage: loads configuration
askai/askai.go - AI query service → AI providers: builds provider
askai/askai.go - AI providers → LLM service: requests completion
- AI query service → Read-only SQL query: queries data
- Read-only SQL query → Deployment database: reads scoped data
aiprovider/query.go