How utkarshj014/authsphere works
AuthSphere is an authentication and authorization platform exposed as an Express REST API; the listed web app is still the stock React/Vite starter, not a demonstrated product client. The principal workflow is an API request routed to authentication logic, which verifies or creates identity/session state and may issue tokens or queue email. Separate branches cover OAuth, MFA/security events, session management, user/role administration, and permission checks. The excerpts show only part of the implementation, so unsampled links are omitted rather than inferred.
Main entry points: auth.service.ts Auth service · oauth.service.ts OAuth flows · app.ts Express application · prisma.ts Prisma client
Components 24
API entry
- Express application
apps/api/src/app.ts
Identity and sessions
- Authentication
apps/api/src/modules/auth - Auth controller
apps/api/src/modules/auth/auth.controller.ts - Auth service
apps/api/src/modules/auth/auth.service.ts - Identity repository
apps/api/src/modules/auth/auth.repository.ts - OAuth flows
apps/api/src/modules/auth/oauth/oauth.service.ts - OAuth controller
apps/api/src/modules/auth/oauth/oauth.controller.ts - OAuth providers
apps/api/src/modules/auth/oauth - Session management
apps/api/src/modules/sessions - Session service
apps/api/src/modules/sessions/sessions.service.ts - Token and MFA crypto
apps/api/src/lib/crypto - JWT issuance
apps/api/src/lib/jwt
Access management
- User management
apps/api/src/modules/users - Role management
apps/api/src/modules/roles - Permission checks
apps/api/src/modules/authorization/authorization.service.ts
Persistence and messaging
- Email queue
apps/api/src/modules/email/email.queue.ts - Email worker
apps/api/src/workers/email.worker.ts - Email delivery
apps/api/src/modules/email/email.service.ts - Prisma client
apps/api/src/lib/prisma.ts - Redis client
apps/api/src/lib/redis.ts - PostgreSQL
Other components
- API caller
- OAuth providers
- Resend
Connections 29
- API caller → Express application: sends request
README.md - Express application → Authentication: routes requests
apps/api/src/app.ts - Express application → Session management: routes requests
apps/api/src/app.ts - Express application → User management: routes requests
apps/api/src/app.ts - Express application → Role management: routes requests
apps/api/src/app.ts - Authentication → Auth controller: registers routes
apps/api/src/modules/auth/index.ts - Auth controller → Auth service: calls
apps/api/src/modules/auth/auth.controller.ts - Auth service → Identity repository: reads and writes
apps/api/src/modules/auth/auth.service.ts - Identity repository → Prisma client: queries
apps/api/src/modules/auth/auth.repository.ts - Auth service → Token and MFA crypto: uses
apps/api/src/modules/auth/auth.service.ts - Auth service → JWT issuance: issues tokens
apps/api/src/modules/auth/auth.service.ts - Auth service → Email queue: queues email
apps/api/src/modules/auth/auth.service.ts - OAuth controller → OAuth flows: calls
apps/api/src/modules/auth/oauth/oauth.controller.ts - OAuth flows → Identity repository: looks up identities
apps/api/src/modules/auth/oauth/oauth.service.ts - OAuth flows → Auth service: creates sessions
apps/api/src/modules/auth/oauth/oauth.service.ts - OAuth flows → Redis client: stores OAuth state
apps/api/src/modules/auth/oauth/oauth.service.ts - OAuth flows → OAuth providers: dispatches to
apps/api/src/modules/auth/oauth/oauth.service.ts - OAuth providers → OAuth flows: authorizes
- Session management → Session service: registers routes
apps/api/src/modules/sessions/sessions.controller.ts - Session service → Authentication: records security event
apps/api/src/modules/sessions/sessions.service.ts - Session service → Prisma client: accesses sessions
- Role management → Permission checks: invalidates permissions
apps/api/src/modules/roles/roles.service.ts - Permission checks → Redis client: caches permissions
apps/api/src/modules/authorization/authorization.service.ts - Permission checks → Prisma client: loads permissions
- User management → Prisma client: persists users
- Prisma client → PostgreSQL: reads and writes
- Email queue → Email worker: dispatches jobs
- Email worker → Email delivery: calls
apps/api/src/workers/email.worker.ts - Email delivery → Resend: sends mail