@mastra/auth-supabase

A Supabase authentication integration for Mastra, providing seamless authentication and authorization capabilities using Supabase's authentication system.

Requirements

- Node.js 22.13.0 or later
- Supabase project with authentication enabled
- Supabase URL and anonymous key

Installation

``bash
npm install @mastra/auth-supabase


or

yarn add @mastra/auth-supabase

or

pnpm add @mastra/auth-supabase
`

Usage

`typescript
import { Mastra } from '@mastra/core/mastra';
import { MastraAuthSupabase } from '@mastra/auth-supabase';

// Initialize with environment variables
const supabaseAuth = new MastraAuthSupabase();

// Or initialize with explicit configuration
const supabaseAuth = new MastraAuthSupabase({
url: 'your-supabase-url',
anonKey: 'your-supabase-anon-key',
});

// Enable auth in Mastra
const mastra = new Mastra({
...
server: {
auth: supabaseAuth,
},
});
`

Configuration

The package can be configured in two ways:

1. Environment Variables:
- SUPABASE_URL: Your Supabase project URL
- SUPABASE_ANON_KEY: Your Supabase anonymous key

2. Constructor Options:
`typescript
interface MastraAuthSupabaseOptions {
url?: string;
anonKey?: string;
}
``

Features

- Authentication: Verifies user tokens and retrieves user information from Supabase
- Authorization: Checks user permissions based on their role in Supabase
- Type Safety: Full TypeScript support with proper type definitions
- Environment Variable Support: Easy configuration through environment variables

API

$3

Authenticates a user token and returns the user information if valid.

$3

Checks if a user has the required permissions (currently checks for admin status).