mirror of
https://github.com/LukeHagar/better-auth.git
synced 2025-12-09 12:27:43 +00:00
183 lines
4.5 KiB
Plaintext
183 lines
4.5 KiB
Plaintext
---
|
||
title: 1.2 Release
|
||
description: Stripe, Captcha, API Keys, Teams, Init CLI, and more.
|
||
date: 2025-03-01
|
||
---
|
||
|
||
# Better Auth 1.2 – Stripe, Captcha, API Keys, Teams, Init CLI, and more
|
||
|
||
To upgrade, run:
|
||
|
||
```package-install
|
||
npm install better-auth@1.2
|
||
```
|
||
|
||
---
|
||
|
||
### **Stripe Plugin (Beta)**
|
||
|
||
Stripe integration for customer management, subscriptions, and webhooks.
|
||
|
||
```package-install
|
||
npm install @better-auth/stripe
|
||
```
|
||
|
||
```ts title="auth.ts"
|
||
import { stripe } from "@better-auth/stripe"; // [!code highlight]
|
||
|
||
export const auth = betterAuth({
|
||
plugins: [
|
||
stripe({
|
||
// [!code highlight]
|
||
createCustomerOnSignup: true, // [!code highlight]
|
||
subscription: { // [!code highlight]
|
||
enabled: true, // [!code highlight]
|
||
plans: [// [!code highlight]
|
||
{ // [!code highlight]
|
||
name: "pro", // [!code highlight]
|
||
priceId: "price_1234567890", // [!code highlight]
|
||
}, // [!code highlight]
|
||
], // [!code highlight]
|
||
}, // [!code highlight]
|
||
}), // [!code highlight]
|
||
],
|
||
});
|
||
```
|
||
|
||
Read the [Stripe Plugin docs](/docs/plugins/stripe) for more information.
|
||
|
||
### **Captcha Plugin**
|
||
|
||
Protect your authentication flows with Google reCAPTCHA and Cloudflare Turnstile. Works for signup, signin, and password resets.
|
||
|
||
```ts title="auth.ts"
|
||
import { captcha } from "better-auth/plugins";
|
||
|
||
const auth = betterAuth({
|
||
plugins: [
|
||
// [!code highlight]
|
||
captcha({
|
||
// [!code highlight]
|
||
provider: "cloudflare-turnstile", // or "google-recaptcha" // [!code highlight]
|
||
secretKey: process.env.TURNSTILE_SECRET_KEY!, // [!code highlight]
|
||
}), // [!code highlight]
|
||
], // [!code highlight]
|
||
});
|
||
```
|
||
|
||
Read the [Captcha Plugin docs](/docs/plugins/captcha) for more information.
|
||
|
||
### **API Key Plugin**
|
||
|
||
Generate and manage API keys with rate limiting, expiration, and metadata. Supports session creation from API keys.
|
||
|
||
```ts title="auth.ts"
|
||
import { apiKey } from "better-auth/plugins";
|
||
|
||
const auth = betterAuth({
|
||
plugins: [apiKey()],
|
||
});
|
||
```
|
||
|
||
Read the [API Key Plugin docs](/docs/plugins/api-key) for more information.
|
||
|
||
### **Teams/Sub-Organizations**
|
||
|
||
Organizations can now have teams or sub-organizations under them.
|
||
|
||
```ts title="auth.ts"
|
||
const auth = betterAuth({
|
||
plugins: [
|
||
organization({
|
||
teams: {
|
||
enabled: true,
|
||
},
|
||
}),
|
||
],
|
||
});
|
||
```
|
||
|
||
Read the [Organization Plugin docs](/docs/plugins/organization#teams) for more information.
|
||
|
||
### **Init CLI**
|
||
|
||
The CLI now includes an `init` command to add better auth to your project.
|
||
|
||
```bash title="terminal"
|
||
npx @better-auth/cli init
|
||
```
|
||
|
||
### **Username**
|
||
|
||
- Added `displayName` for case-insensitive lookups while preserving original formatting.
|
||
- Built-in validation.
|
||
|
||
<Callout type="info">
|
||
If you're using the Username plugin, make sure to add the `displayName` field
|
||
to your schema.
|
||
</Callout>
|
||
|
||
### **Organization**
|
||
|
||
- **Multiple Roles per User** – Assign more than one role to a user.
|
||
|
||
### **Admin Plugin**
|
||
|
||
- Manage roles and permissions within the admin plugin. [Learn more](/docs/plugins/admin)
|
||
- `adminUserIds` option to grant specific users admin privileges. [Learn more](/docs/plugins/admin#usage)
|
||
|
||
---
|
||
|
||
## 🎭 New Social Providers
|
||
|
||
- [TikTok](/docs/authentication/tiktok)
|
||
- [Roblox](/docs/authentication/roblox)
|
||
- [VK](/docs/authentication/vk)
|
||
|
||
---
|
||
|
||
## ✨ Core Enhancements
|
||
|
||
- **Auto Cleanup** for expired verification data
|
||
- **Improved Google One Tap** integration with JWT verification and enhanced prompt handling
|
||
- **Phone-based Password Reset** functionality
|
||
- **Provider Control Options**:
|
||
- Disable signups for specific providers
|
||
- Disable implicit signups for specific providers
|
||
- Control default scopes and allow custom scopes on request
|
||
- **Enhanced Database Hooks** with additional context information
|
||
|
||
---
|
||
|
||
## 🚀 Performance Boosts
|
||
|
||
We rewrote **better-call** (the core library behind Better Auth) to fix TypeScript editor lag. Your IDE should now feel much snappier when working with Better Auth.
|
||
|
||
---
|
||
|
||
## ⚡ CLI Enhancements
|
||
|
||
### **`init` Command**
|
||
|
||
The CLI now includes an `init` command to speed up setup:
|
||
|
||
- Scaffold new projects
|
||
- Generate schemas
|
||
- Run migrations
|
||
|
||
[Learn more](/docs/concepts/cli)
|
||
|
||
---
|
||
|
||
## 🛠 Bug Fixes & Stability Improvements
|
||
|
||
A lot of fixes and refinements to make everything smoother, faster, and more reliable. Check out the [changelog](https://github.com/better-auth/better-auth/releases/tag/v1.2.0) for more details.
|
||
|
||
---
|
||
|
||
```package-install
|
||
npm install better-auth@1.2.0
|
||
```
|
||
|
||
**Upgrade now and take advantage of these powerful new features!** 🚀
|