better-auth-studio 1.1.2-beta.2 → 1.1.2-beta.20

package/README.md

@@ -1,67 +1,21 @@
-# Better Auth Studio 
+# Better Auth Studio
 
 > ⚠️ **Beta Version Notice**
-> 
+>
 > Better Auth Studio is currently in **beta** and in early development. You may encounter bugs or incomplete features. Please report any issues you find on our GitHub repository to help us improve the project. Your feedback is greatly appreciated!
 
-
 A web-based studio interface for managing Better Auth applications. Better Auth Studio provides a comprehensive dashboard for managing users, organizations, teams, and more.
 
-## Preview
-A sneak peek of the studio dashboard and management interface.
-
-<div align="center">
-  <table>
-    <tr>
-      <td width="50%">
-        <img src="https://gk6bju9ndq.ufs.sh/f/M5pOhOFFvHQJI57TKc4BY9GjOlTtSmoRXCZJ2D50IWsLq6vd" alt="Better Auth Studio Preview 0" width="100%" />
-      </td>
-      <td width="50%">
-        <img src="https://gk6bju9ndq.ufs.sh/f/M5pOhOFFvHQJ4L7IilBo7ItO3420CBLpvnPJlA6j5zaFYZbG" alt="Better Auth Studio Preview 4" width="100%" />
-      </td>
-    </tr>
-    <tr>
-      <td width="50%">
-        <img src="https://gk6bju9ndq.ufs.sh/f/M5pOhOFFvHQJdiXpY6GJ15hUVAwrQyozdc6PpIXfSi7GWkeR" alt="Better Auth Studio Preview 2" width="100%" />
-      </td>
-      <td width="50%">
-        <img src="https://gk6bju9ndq.ufs.sh/f/M5pOhOFFvHQJNAk2JU1Cviwfb1ltHVgPJF9BWxzE2m60rQaK" alt="Better Auth Studio Preview 6" width="100%" />
-      </td>
-    </tr>
-    <tr>
-      <td width="50%">
-        <img src="https://gk6bju9ndq.ufs.sh/f/M5pOhOFFvHQJgSyVwl0dZe8UGVJLkR74CQXb9m1wzKIqhTME" alt="Better Auth Studio Preview 11" width="100%" />
-      </td>
-      <td width="50%">
-        <img src="https://gk6bju9ndq.ufs.sh/f/M5pOhOFFvHQJODyqbs8p2EKCNef8H9XqPm4cIwjaQVRUAFg7" alt="Better Auth Studio Preview 8" width="100%" />
-      </td>
-    </tr>
-    <tr>
-      <td width="50%">
-        <img src="https://gk6bju9ndq.ufs.sh/f/M5pOhOFFvHQJ2syhnQSdgJ9w13MfvHiGYPs07AkpWQSXm6Nj" alt="Better Auth Studio Preview 12" width="100%" />
-      </td>
-      <td width="50%">
-        <img src="https://gk6bju9ndq.ufs.sh/f/M5pOhOFFvHQJcW7cwWXSlBtbRHTF15ujAQLPx3VpcKgMOz08" alt="Better Auth Studio Preview 3" width="100%" />
-      </td>
-    </tr>
-    <tr>
-      <td width="50%">
-        <img src="https://gk6bju9ndq.ufs.sh/f/M5pOhOFFvHQJnAGpd3rzcKd2Hu4wkD0jJbApf78rC1VgZORT" alt="Better Auth Studio Preview 10" width="100%" />
-      </td>
-      <td width="50%">
-        <img src="https://gk6bju9ndq.ufs.sh/f/M5pOhOFFvHQJK6lXYfaxUOknshdjxpSgwV6mq7DtH3aMZXWK" alt="Better Auth Studio Preview 13" width="100%" />
-      </td>
-    </tr>
-    <tr>
-      <td width="50%">
-        <img src="https://gk6bju9ndq.ufs.sh/f/M5pOhOFFvHQJhZFdrWmjbSvOe01IQl7r68LUfVKuFcNqAydt" alt="Better Auth Studio Preview 14" width="100%" />
-      </td>
-      <td width="50%">
-        <img src="https://gk6bju9ndq.ufs.sh/f/M5pOhOFFvHQJwnJFq9htT259fPAQY0eIdDmn7O4xVlGaCjZR" alt="Better Auth Studio Preview 5" width="100%" />
-      </td>
-    </tr>
-  </table>
-</div>
+## ✨ Try Better Auth Studio Demo
+
+You can try a live, demo version of Better Auth Studio here:
+
+👉 **[https://bt-nextjs.vercel.app/admin](https://bt-nextjs.vercel.app/admin)**
+
+- **Login email:** `admin@test.com`
+- **Password:** `admin@test.com`
+
+This online demo lets you explore the admin studio UI. Please note this is a test environment.
 
 ## 🚀 Quick Start
 
@@ -88,24 +42,27 @@ pnpm add -g better-auth-studio
 Or use pnpx to run it without installation:
 
 ```bash
-pnpx better-auth-studio [cmd] 
+pnpx better-auth-studio [cmd]
 ```
 
 ### Basic Usage
 
 1. **Navigate to your Better Auth project directory**
+
    ```bash
    cd your-better-auth-project
    ```
 
 2. **Start the studio**
-   
+
    If installed as dev dependency:
+
    ```bash
    pnpm better-auth-studio start
    ```
-   
+
    Or with pnpx:
+
    ```bash
    pnpx better-auth-studio start
    ```
@@ -129,7 +86,7 @@ Before using Better Auth Studio, ensure you have:
 Better Auth Studio automatically detects and works with:
 
 - **Prisma** (`prismaAdapter`)
-- **Drizzle** (`drizzleAdapter`) 
+- **Drizzle** (`drizzleAdapter`)
 - **SQLite** (`new Database()` from better-sqlite3)
 - **PostgreSQL** (via Prisma or Drizzle)
 - **MySQL** (via Prisma or Drizzle)
@@ -137,6 +94,7 @@ Better Auth Studio automatically detects and works with:
 ### Example Configuration Files
 
 #### Prisma Setup
+
 ```typescript
 // auth.ts
 import { betterAuth } from "better-auth";
@@ -154,6 +112,7 @@ export const auth = betterAuth({
 ```
 
 #### Drizzle Setup
+
 ```typescript
 // auth.ts
 import { betterAuth } from "better-auth";
@@ -169,6 +128,7 @@ export const auth = betterAuth({
 ```
 
 #### SQLite Setup
+
 ```typescript
 // auth.ts
 import { betterAuth } from "better-auth";
@@ -183,9 +143,11 @@ export const auth = betterAuth({
 ## 🎯 Features
 
 ### 📊 Dashboard
+
 - **Overview statistics** - User, teams and organization counts data
 
 ### 👥 User Management
+
 - **View all users** - Paginated list with search and filtering
 - **Create users** - Add new users with email/password
 - **Edit users** - Update user information, email verification status
@@ -194,6 +156,7 @@ export const auth = betterAuth({
 - **User details** - View user profiles, and accounts
 
 ### 🏢 Organization Management
+
 - **View organizations** - List all organizations with pagination
 - **Create organizations** - Add new organizations with custom slugs
 - **Edit organizations** - Update organization details
@@ -203,6 +166,7 @@ export const auth = betterAuth({
 - **Bulk seeding** - Generate test organizations and teams
 
 ### ⚙️ Settings & Configuration
+
 - **Plugin status** - Check which Better Auth plugins are enabled
 - **Database configuration** - View current database adapter and settings
 - **Social providers** - Configure OAuth providers (GitHub, Google, etc.)
@@ -211,11 +175,13 @@ export const auth = betterAuth({
 ## 🛠️ Command Line Options
 
 ### Start Studio
+
 ```bash
 pnpx better-auth-studio start [options]
 ```
 
 **Options:**
+
 - `--port <number>` - Specify port (default: 3000)
 - `--host <string>` - Specify host (default: localhost)
 - `--no-open` - Don't automatically open browser
@@ -223,6 +189,7 @@ pnpx better-auth-studio start [options]
 - `--watch` - Watch for changes in auth config file and reload server automatically
 
 **Examples:**
+
 ```bash
 # Start on custom port (if installed as dev dependency)
 pnpm better-auth-studio start --port 3001
@@ -248,6 +215,7 @@ pnpx better-auth-studio start --port 3001 --watch --config ./src/auth.ts
 Specify a custom path to your auth config file when it's in a non-standard location or auto-detection fails.
 
 **Example:**
+
 ```bash
 # With relative path
 pnpm better-auth-studio start --config ./src/lib/auth.ts
@@ -263,6 +231,7 @@ pnpm better-auth-studio start --config /path/to/project/auth.ts
 Automatically reload the server when your `auth.ts` file changes. Perfect for development when iterating on your auth configuration.
 
 **Example:**
+
 ```bash
 # Start with watch mode enabled
 pnpx better-auth-studio start --watch
@@ -271,6 +240,7 @@ pnpx better-auth-studio start --watch
 **How it works:** Monitors your auth config file for changes, automatically restarts the server, and updates the browser UI via WebSocket - no manual refresh needed.
 
 ### Other Commands
+
 ```bash
 # Check version
 pnpx better-auth-studio --version
@@ -298,11 +268,13 @@ pnpm add better-auth-studio
 ### Setup
 
 **Step 1: Initialize configuration**
+
 ```bash
 pnpx better-auth-studio init
 ```
 
 This creates a `studio.config.ts` file:
+
 ```typescript
 import type { StudioConfig } from "better-auth-studio";
 import { auth } from "./lib/auth";
@@ -326,19 +298,14 @@ export default config;
 ### Next.js (App Router)
 
 The init command automatically creates `app/api/studio/[[...path]]/route.ts`:
+
 ```typescript
-import { createStudioHandler } from "better-auth-studio/nextjs";
+import { betterAuthStudio } from "better-auth-studio/nextjs";
 import studioConfig from "@/studio.config";
 
-const handler = createStudioHandler(studioConfig);
+const handler = betterAuthStudio(studioConfig);
 
-export {
-  handler as GET,
-  handler as POST,
-  handler as PUT,
-  handler as DELETE,
-  handler as PATCH,
-};
+export { handler as GET, handler as POST, handler as PUT, handler as DELETE, handler as PATCH };
 ```
 
 Access at `http://localhost:3000/api/studio`
@@ -346,6 +313,7 @@ Access at `http://localhost:3000/api/studio`
 ### Express
 
 Add the studio handler to your server:
+
 ```typescript
 import express from "express";
 import { toNodeHandler } from "better-auth/node";
@@ -366,17 +334,18 @@ Access at `http://localhost:3000/api/studio`
 
 ### Configuration Options
 
-| Option | Required | Description |
-|--------|----------|-------------|
-| `auth` | Yes | Your Better Auth instance |
-| `basePath` | Yes | URL path where studio is mounted |
-| `access.allowEmails` | No | Array of admin email addresses |
-| `access.roles` | No | Array of allowed user roles |
-| `metadata` | No | Custom branding (title, theme) |
+| Option               | Required | Description                      |
+| -------------------- | -------- | -------------------------------- |
+| `auth`               | Yes      | Your Better Auth instance        |
+| `basePath`           | Yes      | URL path where studio is mounted |
+| `access.allowEmails` | No       | Array of admin email addresses   |
+| `access.roles`       | No       | Array of allowed user roles      |
+| `metadata`           | No       | Custom branding (title, theme)   |
 
 ## 📝 Development
 
 ### Running from Source
+
 ```bash
 # Clone the repository
 git clone https://github.com/Kinfe123/better-auth-studio.git
@@ -393,6 +362,7 @@ pnpm dev
 ```
 
 ### Contributing
+
 1. Fork the repository
 2. Create a feature branch
 3. Make your changes

package/data/default-geo.json

@@ -1123,4 +1123,4 @@
   ],
   "totalRanges": 255,
   "countries": 12
-}
+}

package/dist/adapters/astro.d.ts

@@ -1,4 +1,4 @@
-import type { StudioConfig } from '../types/handler.js';
+import type { StudioConfig } from "../types/handler.js";
 /**
  * Astro adapter for Better Auth Studio
  *

package/dist/adapters/astro.js

@@ -1,5 +1,5 @@
-import { handleStudioRequest } from '../core/handler.js';
-import { injectEventHooks } from '../utils/hook-injector.js';
+import { handleStudioRequest } from "../core/handler.js";
+import { injectEventHooks } from "../utils/hook-injector.js";
 /**
  * Astro adapter for Better Auth Studio
  *
@@ -28,10 +28,10 @@ export function betterAuthStudio(config) {
             return universalToResponse(universalRes);
         }
         catch (error) {
-            console.error('Studio handler error:', error);
-            return new Response(JSON.stringify({ error: 'Internal server error' }), {
+            console.error("Studio handler error:", error);
+            return new Response(JSON.stringify({ error: "Internal server error" }), {
                 status: 500,
-                headers: { 'Content-Type': 'application/json' },
+                headers: { "Content-Type": "application/json" },
             });
         }
     };
@@ -40,16 +40,16 @@ async function convertAstroToUniversal(ctx, config) {
     const request = ctx.request;
     let body;
     const method = request.method;
-    if (method !== 'GET' && method !== 'HEAD') {
-        const contentType = request.headers.get('content-type') || '';
-        if (contentType.includes('application/json')) {
+    if (method !== "GET" && method !== "HEAD") {
+        const contentType = request.headers.get("content-type") || "";
+        if (contentType.includes("application/json")) {
             try {
                 body = await request.json();
             }
             catch { }
         }
-        else if (contentType.includes('application/x-www-form-urlencoded') ||
-            contentType.includes('multipart/form-data')) {
+        else if (contentType.includes("application/x-www-form-urlencoded") ||
+            contentType.includes("multipart/form-data")) {
             try {
                 const formData = await request.formData();
                 body = Object.fromEntries(formData.entries());
@@ -75,12 +75,12 @@ async function convertAstroToUniversal(ctx, config) {
     request.headers.forEach((value, key) => {
         headers[key] = value;
     });
-    const basePath = config.basePath || '/api/studio';
-    const normalizedBasePath = basePath.endsWith('/') ? basePath.slice(0, -1) : basePath;
+    const basePath = config.basePath || "/api/studio";
+    const normalizedBasePath = basePath.endsWith("/") ? basePath.slice(0, -1) : basePath;
     const url = new URL(request.url);
     let path = url.pathname;
     if (path.startsWith(normalizedBasePath)) {
-        path = path.slice(normalizedBasePath.length) || '/';
+        path = path.slice(normalizedBasePath.length) || "/";
     }
     const pathWithQuery = path + url.search;
     return {

package/dist/adapters/elysia.d.ts

@@ -1,5 +1,5 @@
-import type { Context } from 'elysia';
-import type { StudioConfig } from '../types/handler.js';
+import type { Context } from "elysia";
+import type { StudioConfig } from "../types/handler.js";
 /**
  * Elysia adapter for Better Auth Studio
  */

package/dist/adapters/elysia.js

@@ -1,5 +1,5 @@
-import { handleStudioRequest } from '../core/handler.js';
-import { injectEventHooks } from '../utils/hook-injector.js';
+import { handleStudioRequest } from "../core/handler.js";
+import { injectEventHooks } from "../utils/hook-injector.js";
 /**
  * Elysia adapter for Better Auth Studio
  */
@@ -14,28 +14,28 @@ export function betterAuthStudio(config) {
             return sendElysiaResponse(context, universalRes);
         }
         catch (error) {
-            console.error('Studio handler error:', error);
+            console.error("Studio handler error:", error);
             context.set.status = 500;
-            return { error: 'Internal server error' };
+            return { error: "Internal server error" };
         }
     };
 }
 async function convertElysiaToUniversal(context) {
     let body;
     const method = context.request.method;
-    if (method !== 'GET' && method !== 'HEAD') {
+    if (method !== "GET" && method !== "HEAD") {
         const elysiaBody = context.body ?? context.query ?? undefined;
         if (elysiaBody !== undefined) {
             body = elysiaBody;
         }
         else {
-            const contentType = context.request.headers.get('content-type') || '';
+            const contentType = context.request.headers.get("content-type") || "";
             try {
-                if (contentType.includes('application/json')) {
+                if (contentType.includes("application/json")) {
                     body = await context.request.json();
                 }
-                else if (contentType.includes('application/x-www-form-urlencoded') ||
-                    contentType.includes('multipart/form-data')) {
+                else if (contentType.includes("application/x-www-form-urlencoded") ||
+                    contentType.includes("multipart/form-data")) {
                     const formData = await context.request.formData();
                     body = Object.fromEntries(formData.entries());
                 }
@@ -78,9 +78,9 @@ function sendElysiaResponse(context, universal) {
             headers: universal.headers,
         });
     }
-    else if (typeof universal.body === 'string') {
-        const contentType = universal.headers['content-type'] || universal.headers['Content-Type'] || '';
-        if (contentType.includes('application/json')) {
+    else if (typeof universal.body === "string") {
+        const contentType = universal.headers["content-type"] || universal.headers["Content-Type"] || "";
+        if (contentType.includes("application/json")) {
             try {
                 return JSON.parse(universal.body);
             }
@@ -88,7 +88,7 @@ function sendElysiaResponse(context, universal) {
                 return universal.body;
             }
         }
-        else if (contentType.includes('text/html')) {
+        else if (contentType.includes("text/html")) {
             return new Response(universal.body, {
                 status: universal.status,
                 headers: universal.headers,

package/dist/adapters/express.d.ts

@@ -1,5 +1,5 @@
-import type { Router as ExpressRouter } from 'express';
-import type { StudioConfig } from '../types/handler.js';
+import type { Router as ExpressRouter } from "express";
+import type { StudioConfig } from "../types/handler.js";
 /**
  * Express adapter for Better Auth Studio
  */

package/dist/adapters/express.js

@@ -1,6 +1,6 @@
-import { Router } from 'express';
-import { handleStudioRequest } from '../core/handler.js';
-import { injectEventHooks } from '../utils/hook-injector.js';
+import { Router } from "express";
+import { handleStudioRequest } from "../core/handler.js";
+import { injectEventHooks } from "../utils/hook-injector.js";
 /**
  * Express adapter for Better Auth Studio
  */
@@ -9,7 +9,7 @@ export function betterAuthStudio(config) {
         injectEventHooks(config.auth, config.events);
     }
     const router = Router();
-    router.all('*', async (req, res, next) => {
+    router.all("*", async (req, res, next) => {
         try {
             const universalReq = convertExpressToUniversal(req);
             const universalRes = await handleStudioRequest(universalReq, config);

package/dist/adapters/hono.d.ts

@@ -1,5 +1,5 @@
-import type { Context } from 'hono';
-import type { StudioConfig } from '../types/handler.js';
+import type { Context } from "hono";
+import type { StudioConfig } from "../types/handler.js";
 /**
  * Hono adapter for Better Auth Studio
  */

package/dist/adapters/hono.js

@@ -1,5 +1,5 @@
-import { handleStudioRequest } from '../core/handler.js';
-import { injectEventHooks } from '../utils/hook-injector.js';
+import { handleStudioRequest } from "../core/handler.js";
+import { injectEventHooks } from "../utils/hook-injector.js";
 /**
  * Hono adapter for Better Auth Studio
  */
@@ -14,23 +14,23 @@ export function betterAuthStudio(config) {
             return sendHonoResponse(c, universalRes);
         }
         catch (error) {
-            console.error('Studio handler error:', error);
-            return c.json({ error: 'Internal server error' }, 500);
+            console.error("Studio handler error:", error);
+            return c.json({ error: "Internal server error" }, 500);
         }
     };
 }
 async function convertHonoToUniversal(c) {
     let body;
     const method = c.req.method;
-    if (method !== 'GET' && method !== 'HEAD') {
-        const contentType = c.req.header('content-type') || '';
-        if (contentType.includes('application/json')) {
+    if (method !== "GET" && method !== "HEAD") {
+        const contentType = c.req.header("content-type") || "";
+        if (contentType.includes("application/json")) {
             try {
                 body = await c.req.json();
             }
             catch { }
         }
-        else if (contentType.includes('application/x-www-form-urlencoded')) {
+        else if (contentType.includes("application/x-www-form-urlencoded")) {
             try {
                 body = await c.req.parseBody();
             }
@@ -58,9 +58,9 @@ function sendHonoResponse(c, universal) {
     if (Buffer.isBuffer(universal.body)) {
         return c.body(universal.body);
     }
-    else if (typeof universal.body === 'string') {
-        const contentType = universal.headers['content-type'] || universal.headers['Content-Type'] || '';
-        if (contentType.includes('application/json')) {
+    else if (typeof universal.body === "string") {
+        const contentType = universal.headers["content-type"] || universal.headers["Content-Type"] || "";
+        if (contentType.includes("application/json")) {
             try {
                 return c.json(JSON.parse(universal.body));
             }
@@ -68,7 +68,7 @@ function sendHonoResponse(c, universal) {
                 return c.text(universal.body);
             }
         }
-        else if (contentType.includes('text/html')) {
+        else if (contentType.includes("text/html")) {
             return c.html(universal.body);
         }
         else {

package/dist/adapters/nextjs.d.ts

@@ -1,3 +1,3 @@
-import type { StudioConfig } from '../types/handler.js';
+import type { StudioConfig } from "../types/handler.js";
 export declare function betterAuthStudio(config: StudioConfig): (request: Request) => Promise<Response>;
 //# sourceMappingURL=nextjs.d.ts.map

package/dist/adapters/nextjs.js

@@ -1,9 +1,9 @@
-import { handleStudioRequest } from '../core/handler.js';
-import { injectEventHooks } from '../utils/hook-injector.js';
+import { handleStudioRequest } from "../core/handler.js";
+import { injectEventHooks } from "../utils/hook-injector.js";
 function getUrlFromRequest(req) {
     const nextUrl = req.nextUrl;
-    if (nextUrl && typeof nextUrl.pathname === 'string') {
-        return nextUrl.pathname + (nextUrl.search || '');
+    if (nextUrl && typeof nextUrl.pathname === "string") {
+        return nextUrl.pathname + (nextUrl.search || "");
     }
     const url = new URL(req.url);
     return url.pathname + url.search;
@@ -19,19 +19,19 @@ export function betterAuthStudio(config) {
             return universalToResponse(universalResponse);
         }
         catch (error) {
-            console.error('Studio handler error:', error);
-            return new Response(JSON.stringify({ error: 'Internal server error' }), {
+            console.error("Studio handler error:", error);
+            return new Response(JSON.stringify({ error: "Internal server error" }), {
                 status: 500,
-                headers: { 'Content-Type': 'application/json' },
+                headers: { "Content-Type": "application/json" },
             });
         }
     };
 }
 async function requestToUniversal(req) {
     let body;
-    if (req.method !== 'GET' && req.method !== 'HEAD') {
-        const contentType = req.headers.get('content-type') || '';
-        if (contentType.includes('application/json')) {
+    if (req.method !== "GET" && req.method !== "HEAD") {
+        const contentType = req.headers.get("content-type") || "";
+        if (contentType.includes("application/json")) {
             try {
                 body = await req.json();
             }

package/dist/adapters/nuxt.d.ts

@@ -1,4 +1,4 @@
-import type { StudioConfig } from '../types/handler.js';
+import type { StudioConfig } from "../types/handler.js";
 /**
  * Nuxt adapter for Better Auth Studio
  *