oRPC Better Auth Integration

Files (2)

• SKILL.md
• metadata.json

SKILL.md (first lines)

# Better Auth Integration

[Better Auth](https://better-auth.com/) is a framework-agnostic, universal authentication and authorization framework for TypeScript.

## Step 1: Define Context Headers

Access request headers in your context — manually or via the [Request Headers Plugin](/docs/plugins/request-headers).

### Option A: Manual

```ts
import { os } from '@orpc/server'

export const base = os.$context<{ headers: Headers }>()
```

### Option B: Request Headers Plugin

Use the plugin's setup.

## Step 2: Create Auth Middleware

```ts
import { auth } from './auth' // Your Better Auth instance
import { base } from './context'
import { ORPCError } from '@orpc/server'

export const authMiddleware = base.middleware(async ({ context, next }) => {
  const sessionData = await auth.api.getSession({
    headers: context.headers,
  })

  if (!sessionData?.session || !sessionData?.user) {
    throw new ORPCError('UNAUTHORIZED')
  }

  return next({
    context: {
      session: sessionData.session,
      user: sessionData.user
    },
  })
})
```

## Usage

Create an `authorized` base that includes the auth middleware:

```ts
import { base } from './context'
import { authMiddleware } from './middlewares/auth'

export const authorized = base.use(authMiddleware)
```

Now use it to create authenticated procedures:

```ts
import { authorized } from './authorized'

export const getMessages = authorized.handler(({ context }) => {
  // context.session and context.user are guaranteed to be defined
})
```

From ali-master/skills, MIT.

More from ali-master/skills