ArctonArcton
Integraciones

Better Auth

Registra el handler de Better Auth en Arcton y accede a la sesión actual en tus rutas.

Better Auth es una librería de autenticación independiente del framework. Expone un handler estándar de la Web — una función que recibe un Request y devuelve un Response — junto con una pequeña API de servidor para leer la sesión actual.

Esta guía asume que ya tienes una app de Arcton y una instancia de Better Auth configurada. Si todavía no configuraste Better Auth, consulta su propia guía de instalación. Cada ejemplo de abajo importa esa instancia desde un módulo local ./auth — un reemplazo de la tuya:

auth.ts
declare const auth: {
  handler: (request: Request) => Promise<Response>
  api: {
    getSession: (options: {
      headers: Headers
    }) => Promise<{
      user: { id: string; email: string }
      session: { id: string }
    } | null>
  }
}

export { auth }

Instalación

bun add better-auth

Registrar el handler de Better Auth

El auth.handler de Better Auth recibe un Request y devuelve un Response. Reenvía cada solicitud bajo tu ruta de autenticación con app.all():

index.ts
import { Arcton } from '@arcton/core'
import { auth } from './auth'

const app = Arcton()

app.all('/api/auth/*path', ctx => auth.handler(ctx.request))

app.listen()

app.all() registra el mismo handler para todos los métodos HTTP que soporta Arcton, así que esta única ruta responde a GET, POST y el resto de métodos que necesitan las rutas de Better Auth: registro, inicio de sesión, cierre de sesión, consulta de sesión, y demás.

Un handler puede devolver un Response directamente, y Arcton lo envía tal cual, así que la respuesta de auth.handler llega al cliente sin cambios. Consulta Response para más detalles.

*path es un wildcard y requiere al menos un segmento, por lo que una solicitud a /api/auth sola no coincide. Si tu aplicación necesita manejar esa ruta exacta, regístrala aparte: app.all('/api/auth', ctx => auth.handler(ctx.request)).

CORS

Si tu frontend corre en otro origen, agrega @arcton/cors antes de la ruta de autenticación, con credentials: true para que la cookie de sesión se envíe entre orígenes. Agrega ese mismo origen a trustedOrigins de Better Auth:

index.ts
import { Arcton } from '@arcton/core'
import { cors } from '@arcton/cors'
import { auth } from './auth'

const app = Arcton()

app.use(
  cors({
    origin: 'http://localhost:3001',
    credentials: true,
    allowedHeaders: ['Content-Type', 'Authorization']
  })
)

app.all('/api/auth/*path', ctx => auth.handler(ctx.request))

app.listen()

Consulta CORS para ver todas las opciones disponibles.

Acceder a la sesión en rutas protegidas

Usa auth.api.getSession() para leer la sesión actual a partir de los encabezados de la solicitud, y expón esa información con provide() para que esté disponible en ctx en cualquier ruta registrada después:

index.ts
import { Arcton } from '@arcton/core'
import { auth } from './auth'

const app = Arcton()
  .provide(async ctx => {
    const session = await auth.api.getSession({ headers: ctx.request.headers })
    return { user: session?.user ?? null, session: session?.session ?? null }
  })

app.all('/api/auth/*path', ctx => auth.handler(ctx.request))

app.get(
  '/me',
  async (ctx, next) => {
    if (!ctx.user) return new Response('Unauthorized', { status: 401 })
    await next()
  },
  ctx => ({ user: ctx.user })
)

app.listen()

ctx.user y ctx.session son null cuando no hay una sesión activa. Agrega un middleware como el de arriba a cualquier ruta que deba requerir autenticación — puedes aplicarlo por ruta, o con use() sobre toda una sección de rutas.

Ejemplo completo

index.ts
import { Arcton } from '@arcton/core'
import { cors } from '@arcton/cors'
import { auth } from './auth'

const app = Arcton()
  .use(
    cors({
      origin: 'http://localhost:3001',
      credentials: true,
      allowedHeaders: ['Content-Type', 'Authorization']
    })
  )
  .provide(async ctx => {
    const session = await auth.api.getSession({ headers: ctx.request.headers })
    return { user: session?.user ?? null, session: session?.session ?? null }
  })

app.all('/api/auth/*path', ctx => auth.handler(ctx.request))

app.get(
  '/me',
  async (ctx, next) => {
    if (!ctx.user) return new Response('Unauthorized', { status: 401 })
    await next()
  },
  ctx => ({ user: ctx.user })
)

app.get('/posts', ctx => ({ posts: [], viewer: ctx.user }))

app.listen()

Esto funciona igual en Bun y en Node — Arcton entrega a auth.handler un Request estándar en cualquiera de los dos runtimes.

En esta página