Providers

Authentication Providers

elysia-auth supports all providers from @auth/core, making it easy to implement various authentication strategies.

Available Providers

OAuth Providers

Email Providers

Credentials

Use email/password authentication:

import { ElysiaAuth } from 'elysia-auth'
import Credentials from '@auth/core/providers/credentials'
 
new Elysia()
  .use(ElysiaAuth({
    providers: [
      Credentials({
        credentials: {
          email: {
            type: "email",
            label: "Email",
            placeholder: "john@example.com"
          },
          password: {
            type: "password",
            label: "Password"
          }
        },
        async authorize(credentials) {
          // Add your authentication logic here
          const user = await validateUser(credentials)
          return user
        }
      })
    ]
  }))

OAuth Configuration

Google Example

import { ElysiaAuth } from 'elysia-auth'
import Google from '@auth/core/providers/google'
 
new Elysia()
  .use(ElysiaAuth({
    providers: [
      Google({
        clientId: process.env.AUTH_GOOGLE_ID,
        clientSecret: process.env.AUTH_GOOGLE_SECRET,
        authorization: {
          params: {
            prompt: "consent",
            access_type: "offline",
            response_type: "code"
          }
        }
      })
    ]
  }))

GitHub Example

import { ElysiaAuth } from 'elysia-auth'
import GitHub from '@auth/core/providers/github'
 
new Elysia()
  .use(ElysiaAuth({
    providers: [
      GitHub({
        clientId: process.env.AUTH_GITHUB_ID,
        clientSecret: process.env.AUTH_GITHUB_SECRET
      })
    ]
  }))

Multiple Providers

You can combine multiple providers:

import { ElysiaAuth } from 'elysia-auth'
import Google from '@auth/core/providers/google'
import GitHub from '@auth/core/providers/github'
import Credentials from '@auth/core/providers/credentials'
 
new Elysia()
  .use(ElysiaAuth({
    providers: [
      Google({
        clientId: process.env.AUTH_GOOGLE_ID,
        clientSecret: process.env.AUTH_GOOGLE_SECRET
      }),
      GitHub({
        clientId: process.env.AUTH_GITHUB_ID,
        clientSecret: process.env.AUTH_GITHUB_SECRET
      }),
      Credentials({
        // ... credentials config
      })
    ]
  }))

Custom Providers

You can create custom providers by implementing the provider interface:

import { Provider } from '@auth/core/providers'
 
const CustomProvider: Provider = {
  id: "custom",
  name: "Custom Provider",
  type: "credentials",
  // Implement required methods
}

Next Steps

Getting StartedExamples