Better Auth
Register Better Auth's handler in Arcton and access the current session in your routes.
Better Auth is a framework-agnostic
authentication library. It exposes a standard Web handler — a function that
takes a Request and returns a Response — along with a small server-side
API for reading the current session.
This guide assumes you already have an Arcton app and a configured Better
Auth instance. If you haven't set up Better Auth yet, see its own
installation guide. Every
example below imports that instance from a local ./auth module — a stand-in
for yours:
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 }Installation
bun add better-authRegister the Better Auth handler
Better Auth's auth.handler takes a Request and returns a Response.
Forward every request under your auth path to it with
app.all():
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() registers the same handler for every HTTP method Arcton
supports, so this one route answers GET, POST, and everything else
Better Auth's routes need — sign-up, sign-in, sign-out, session lookup, and
so on.
A handler can return a Response directly, and Arcton sends it through
unchanged, so auth.handler's response reaches the client as-is. See
Response for more.
*path is a wildcard and requires at
least one path segment, so a request to /api/auth on its own doesn't
match. Register it separately if your app needs to handle that exact path:
app.all('/api/auth', ctx => auth.handler(ctx.request)).
CORS
If your frontend runs on a different origin, add
@arcton/cors before the auth route, with
credentials: true so the session cookie is sent cross-origin. Add that
same origin to Better Auth's trustedOrigins:
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()See CORS for the full set of options.
Accessing the session in protected routes
Use auth.api.getSession() to read the current session from the request
headers, and expose it with provide() so it's
available on ctx for any route registered afterward:
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 and ctx.session are null when there's no active session. Add
a middleware like the one above to any route that should require
authentication — apply it per route, or scope it with use() over a whole
section of routes.
Complete example
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()This works the same way on Bun and Node — Arcton hands auth.handler a
standard Request on either runtime.