SvelteKit Adapter
Adapter for integrating Better Auth Studio with SvelteKit applications.
Import
import { betterAuthStudio } from 'better-auth-studio/svelte-kit';
betterAuthStudio()
Creates a SvelteKit-compatible request handler for Better Auth Studio.
Function Signature
function betterAuthStudio(config: StudioConfig): (event: RequestEvent) => Promise<Response>
Parameters
Studio configuration object containing authentication and feature settings.Show StudioConfig properties
Your Better Auth instance
Base path for the studio routes. Default: "/api/studio"
Access control configuration for the studio
Customization options for branding and theming
Last-seen tracking configuration
IP geolocation provider configuration
Event tracking and ingestion configuration
Tools configuration with exclude list
Returns
An async function that accepts a SvelteKit RequestEvent and returns a Response
Usage
Catch-all Route Handler
Create a catch-all route to handle all studio requests:
// src/routes/api/studio/[...path]/+server.ts
import { betterAuthStudio } from 'better-auth-studio/svelte-kit';
import { auth } from '$lib/server/auth';
import { defineStudioConfig } from 'better-auth-studio';
import type { RequestEvent } from '@sveltejs/kit';
const studioConfig = defineStudioConfig({
auth,
basePath: '/api/studio',
metadata: {
title: 'My App Studio',
theme: 'dark'
},
events: {
enabled: true,
tableName: 'auth_events'
}
});
const handler = betterAuthStudio(studioConfig);
export async function GET(event: RequestEvent) {
return handler(event);
}
export async function POST(event: RequestEvent) {
return handler(event);
}
export async function PUT(event: RequestEvent) {
return handler(event);
}
export async function DELETE(event: RequestEvent) {
return handler(event);
}
export async function PATCH(event: RequestEvent) {
return handler(event);
}
Simplified Version
// src/routes/api/studio/[...path]/+server.ts
import { betterAuthStudio } from 'better-auth-studio/svelte-kit';
import { auth } from '$lib/server/auth';
const handler = betterAuthStudio({ auth });
export const GET = handler;
export const POST = handler;
export const PUT = handler;
export const DELETE = handler;
export const PATCH = handler;
With Access Control
// src/routes/api/studio/[...path]/+server.ts
import { betterAuthStudio } from 'better-auth-studio/svelte-kit';
import { auth } from '$lib/server/auth';
const handler = betterAuthStudio({
auth,
access: {
roles: ['admin'],
allowEmails: ['[email protected]']
}
});
export const GET = handler;
export const POST = handler;
export const PUT = handler;
export const DELETE = handler;
export const PATCH = handler;
Implementation Details
Request Conversion
The adapter converts SvelteKit RequestEvent to the universal format:
type UniversalRequest = {
url: string; // Pathname + search (with basePath stripped)
method: string; // event.request.method
headers: Record<string, string>; // event.request.headers
body?: any; // Parsed from event.request
};
Base Path Handling
The adapter automatically strips the base path from the URL:
// If basePath is '/api/studio'
// And request URL is '/api/studio/users'
// The universal URL will be '/users'
Content Type Handling
The adapter handles multiple content types:
application/json → event.request.json()application/x-www-form-urlencoded → FormData converted to objectmultipart/form-data → FormData converted to object- Other → Attempts to parse as text, then JSON
Error Handling
Errors are caught and returned as JSON responses:
{
error: "Internal server error"
}
500
SvelteKit Configuration
TypeScript Types
The adapter uses @ts-expect-error for SvelteKit imports to ensure compatibility when types are not available:
// @ts-expect-error - SvelteKit types may not be available
import type { RequestEvent } from '@sveltejs/kit';
File Structure
src/
├── routes/
│ └── api/
│ └── studio/
│ └── [...path]/
│ └── +server.ts
└── lib/
└── server/
└── auth.ts