@mastra/auth-better-auth 1.1.5-alpha.0 → 1.1.5-alpha.1

package/README.md

@@ -1,21 +1,23 @@
 # @mastra/auth-better-auth
 
-Better Auth integration for Mastra - a self-hosted, open-source authentication solution.
+`@mastra/auth-better-auth` connects a Better Auth instance to Mastra's server authentication layer. Use it when you want a self-hosted, TypeScript-first authentication system that you control instead of relying on a hosted identity provider.
 
 ## Installation
 
 ```bash
-npm install @mastra/auth-better-auth better-auth
+npm install @mastra/auth-better-auth
+npm install better-auth
 ```
 
 ## Usage
 
+Create a Better Auth instance with your database configuration, then register its Mastra adapter under `server.auth`.
+
 ```typescript
-import { betterAuth } from 'better-auth';
 import { MastraAuthBetterAuth } from '@mastra/auth-better-auth';
-import { Mastra } from '@mastra/core';
+import { Mastra } from '@mastra/core/mastra';
+import { betterAuth } from 'better-auth';
 
-// Create your Better Auth instance
 const auth = betterAuth({
   database: {
     provider: 'postgresql',
@@ -26,82 +28,22 @@ const auth = betterAuth({
   },
 });
 
-// Create the Mastra auth provider
-const mastraAuth = new MastraAuthBetterAuth({
-  auth,
-});
-
-// Use with Mastra
-const mastra = new Mastra({
+export const mastra = new Mastra({
   server: {
-    auth: mastraAuth,
-  },
-});
-```
-
-## Configuration Options
-
-| Option          | Type                                  | Required | Description                                                  |
-| --------------- | ------------------------------------- | -------- | ------------------------------------------------------------ |
-| `auth`          | `Auth`                                | Yes      | Your Better Auth instance created via `betterAuth({ ... })`  |
-| `name`          | `string`                              | No       | Custom name for the auth provider (default: `'better-auth'`) |
-| `authorizeUser` | `(user, request) => Promise<boolean>` | No       | Custom authorization logic                                   |
-| `public`        | `string[]`                            | No       | Public routes that don't require authentication              |
-| `protected`     | `string[]`                            | No       | Protected routes that require authentication                 |
-
-## Custom Authorization
-
-You can provide custom authorization logic:
-
-```typescript
-const mastraAuth = new MastraAuthBetterAuth({
-  auth,
-  async authorizeUser(user) {
-    // Only allow verified emails
-    return user?.user?.emailVerified === true;
-  },
-});
-```
-
-## Role-Based Access Control
-
-```typescript
-const mastraAuth = new MastraAuthBetterAuth({
-  auth,
-  async authorizeUser(user) {
-    // Check for admin role (assuming you have a role field)
-    const userWithRole = user?.user as any;
-    return userWithRole?.role === 'admin';
+    auth: new MastraAuthBetterAuth({ auth }),
   },
 });
 ```
 
-## Route Configuration
-
-```typescript
-const mastraAuth = new MastraAuthBetterAuth({
-  auth,
-  public: ['/health', '/api/status'],
-  protected: ['/api/*', '/admin/*'],
-});
-```
-
-## Why Better Auth?
-
-Better Auth is a self-hosted, open-source authentication framework that gives you:
+## Documentation
 
-- **Full control** over your authentication system
-- **No vendor lock-in** - host it yourself
-- **Flexible** - works with various databases and providers
-- **TypeScript-first** - full type safety
-- **Plugin system** - extend with OAuth, 2FA, organizations, etc.
+- [Better Auth integration guide](https://mastra.ai/integrations/auth/better-auth)
+- [Better Auth provider reference](https://mastra.ai/reference/auth/better-auth)
 
-## Resources
+## Changelog
 
-- [Better Auth Documentation](https://better-auth.com)
-- [Mastra Documentation](https://mastra.ai/docs)
-- [GitHub Repository](https://github.com/mastra-ai/mastra)
+See the [package changelog](https://github.com/mastra-ai/mastra/blob/main/auth/better-auth/CHANGELOG.md) for version history and release notes.
 
-## License
+## Support
 
-Apache-2.0
+We have an [open community Discord](https://discord.gg/mastra-ai). Come and say hello and let us know if you have any questions or need any help getting things running.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/auth-better-auth",
-  "version": "1.1.5-alpha.0",
+  "version": "1.1.5-alpha.1",
   "description": "Mastra Better Auth integration - self-hosted authentication",
   "type": "module",
   "main": "dist/index.js",
@@ -34,9 +34,9 @@
     "tsdown": "0.22.9",
     "typescript": "^7.0.2",
     "vitest": "4.1.10",
-    "@internal/lint": "0.0.129",
     "@internal/auth": "0.0.19",
-    "@internal/types-builder": "0.0.104"
+    "@internal/types-builder": "0.0.104",
+    "@internal/lint": "0.0.129"
   },
   "files": [
     "dist"