How nextauthjs/next-auth works
Auth.js is a full-stack authentication toolkit: framework integrations expose authentication endpoints and client helpers, while the core handles sign-in and session operations. Its provider catalog supports OAuth/OIDC, email/passwordless and WebAuthn; applications may use database-backed adapters or stateless sessions. The graph preserves the major documented capabilities, but several core and framework modules were not sampled, so their internal call sequence is not asserted.
Main entry points: src/index.ts Auth engine · src/index.ts Cloudflare D1 adapter · next-auth/src Next.js integration · frameworks-express/src Framework entry points
Components 19
Framework integrations
- Framework entry points
packages/frameworks-express/src - Next.js integration
packages/next-auth/src - SvelteKit integration
packages/frameworks-sveltekit/src - Qwik integration
packages/frameworks-qwik/src
Authentication core
- Auth engine
packages/core/src/index.ts - Auth actions
packages/core/src/lib/actions - Session and JWT
packages/core/src/lib/actions/session.ts - OAuth/OIDC flow
packages/core/src/providers/oauth.ts - WebAuthn client
packages/next-auth/src/webauthn.ts
Sign-in methods
- Provider catalog
packages/core/src/providers - Email sign-in
packages/core/src/providers/email.ts - Passkey provider
packages/core/src/providers/passkey.ts
Persistence adapters
- Adapter contract
packages/utils/adapter.ts - Cloudflare D1 adapter
packages/adapter-d1/src/index.ts - D1 queries
packages/adapter-d1/src/queries.ts - D1 migrations
packages/adapter-d1/src/migrations.ts - Database adapters
packages
Other components
- Application user
- Application database
Connections 17
- Application user → Framework entry points: uses
- Framework entry points → Auth engine: dispatches auth
- Next.js integration → Auth engine: uses core
packages/next-auth/src/lib/client.ts - SvelteKit integration → Auth engine: uses core
packages/frameworks-sveltekit/src/lib/client.ts - Auth engine → Auth actions: handles auth actions
- Auth engine → OAuth/OIDC flow: supports OAuth/OIDC
packages/core/src/providers/oauth.ts - Auth engine → Provider catalog: offers providers
packages/core/src/providers/oauth.ts - Auth engine → Email sign-in: supports passwordless
- Auth engine → Passkey provider: supports WebAuthn
- Next.js integration → WebAuthn client: exposes passkey flow
packages/next-auth/src/webauthn.ts - Auth engine → Session and JWT: manages sessions
- Auth engine → Adapter contract: defines adapter contract
packages/utils/adapter.ts - Cloudflare D1 adapter → D1 queries: uses queries
packages/adapter-d1/src/index.ts - Cloudflare D1 adapter → D1 migrations: uses migrations
packages/adapter-d1/src/index.ts - Cloudflare D1 adapter → Application database: reads/writes
packages/adapter-d1/src/index.ts - Database adapters → Application database: persist auth data
- Adapter contract → Auth engine: integrates with
packages/utils/adapter.ts