@neondatabase/auth 0.1.0-beta.2 → 0.1.0-beta.20

package/dist/vanilla/adapters/index.d.mts

@@ -1,4 +1,5 @@
-import "../../adapter-core-C12KoaiU.mjs";
-import { a as BetterAuthVanillaAdapter, c as BetterAuthVanillaAdapterOptions, i as SupabaseAuthAdapterOptions, n as SupabaseAuthAdapterBuilder, o as BetterAuthVanillaAdapterBuilder, r as SupabaseAuthAdapterInstance, s as BetterAuthVanillaAdapterInstance, t as SupabaseAuthAdapter } from "../../supabase-adapter-crabDnl2.mjs";
-import "../../index-UW23fDSn.mjs";
+import "../../better-auth-types-BUiggBfa.mjs";
+import "../../adapter-core-23fYTUxT.mjs";
+import { a as BetterAuthVanillaAdapter, c as BetterAuthVanillaAdapterOptions, i as SupabaseAuthAdapterOptions, n as SupabaseAuthAdapterBuilder, o as BetterAuthVanillaAdapterBuilder, r as SupabaseAuthAdapterInstance, s as BetterAuthVanillaAdapterInstance, t as SupabaseAuthAdapter } from "../../supabase-adapter-Dr-pKvPt.mjs";
+import "../../index-LhFpnU-f.mjs";
 export { BetterAuthVanillaAdapter, BetterAuthVanillaAdapterBuilder, BetterAuthVanillaAdapterInstance, BetterAuthVanillaAdapterOptions, SupabaseAuthAdapter, SupabaseAuthAdapterBuilder, SupabaseAuthAdapterInstance, SupabaseAuthAdapterOptions };

package/dist/vanilla/adapters/index.mjs

@@ -1,3 +1,4 @@
-import { n as BetterAuthVanillaAdapter, t as SupabaseAuthAdapter } from "../../supabase-adapter-ggmqWgPe.mjs";
+import "../../adapter-core-8s6XdCco.mjs";
+import { n as BetterAuthVanillaAdapter, t as SupabaseAuthAdapter } from "../../supabase-adapter-BYMJSxOT.mjs";
 
 export { BetterAuthVanillaAdapter, SupabaseAuthAdapter };

package/dist/vanilla/index.d.mts

@@ -1,4 +1,5 @@
-import "../adapter-core-C12KoaiU.mjs";
-import { a as BetterAuthVanillaAdapter, c as BetterAuthVanillaAdapterOptions, i as SupabaseAuthAdapterOptions, n as SupabaseAuthAdapterBuilder, o as BetterAuthVanillaAdapterBuilder, r as SupabaseAuthAdapterInstance, s as BetterAuthVanillaAdapterInstance, t as SupabaseAuthAdapter } from "../supabase-adapter-crabDnl2.mjs";
-import "../index-UW23fDSn.mjs";
+import "../better-auth-types-BUiggBfa.mjs";
+import "../adapter-core-23fYTUxT.mjs";
+import { a as BetterAuthVanillaAdapter, c as BetterAuthVanillaAdapterOptions, i as SupabaseAuthAdapterOptions, n as SupabaseAuthAdapterBuilder, o as BetterAuthVanillaAdapterBuilder, r as SupabaseAuthAdapterInstance, s as BetterAuthVanillaAdapterInstance, t as SupabaseAuthAdapter } from "../supabase-adapter-Dr-pKvPt.mjs";
+import "../index-LhFpnU-f.mjs";
 export { BetterAuthVanillaAdapter, BetterAuthVanillaAdapterBuilder, BetterAuthVanillaAdapterInstance, BetterAuthVanillaAdapterOptions, SupabaseAuthAdapter, SupabaseAuthAdapterBuilder, SupabaseAuthAdapterInstance, SupabaseAuthAdapterOptions };

package/dist/vanilla/index.mjs

@@ -1,3 +1,4 @@
-import { n as BetterAuthVanillaAdapter, t as SupabaseAuthAdapter } from "../supabase-adapter-ggmqWgPe.mjs";
+import "../adapter-core-8s6XdCco.mjs";
+import { n as BetterAuthVanillaAdapter, t as SupabaseAuthAdapter } from "../supabase-adapter-BYMJSxOT.mjs";
 
 export { BetterAuthVanillaAdapter, SupabaseAuthAdapter };

package/llms.txt

@@ -0,0 +1,172 @@
+# @neondatabase/auth
+
+> TypeScript SDK for Neon Auth - authentication adapters for PostgreSQL with session caching, request deduplication, and optional anonymous access.
+
+`@neondatabase/auth` provides authentication for applications using Neon Auth. It uses the Better Auth API by default, with optional adapters for different API styles (Supabase-compatible, React hooks).
+
+## Installation
+
+```bash
+npm install @neondatabase/auth
+```
+
+## Quick Start
+
+```typescript
+import { createAuthClient } from '@neondatabase/auth';
+
+const auth = createAuthClient('https://your-auth-server.com');
+
+// Sign up
+await auth.signUp.email({
+  email: 'user@example.com',
+  password: 'secure-password',
+  name: 'John Doe',
+});
+
+// Sign in
+await auth.signIn.email({
+  email: 'user@example.com',
+  password: 'secure-password',
+});
+
+// Get session
+const session = await auth.getSession();
+
+// Sign out
+await auth.signOut();
+```
+
+## OAuth Authentication
+
+```typescript
+await auth.signIn.social({
+  provider: 'google',
+  callbackURL: '/dashboard',
+});
+```
+
+## Adapters
+
+### SupabaseAuthAdapter
+
+Supabase-compatible API for migrations:
+
+```typescript
+import { createAuthClient, SupabaseAuthAdapter } from '@neondatabase/auth';
+
+const auth = createAuthClient('https://your-auth-server.com', {
+  adapter: SupabaseAuthAdapter(),
+});
+
+await auth.signUp({
+  email: 'user@example.com',
+  password: 'secure-password',
+  options: { data: { name: 'John Doe' } },
+});
+
+await auth.signInWithPassword({
+  email: 'user@example.com',
+  password: 'secure-password',
+});
+
+await auth.signInWithOAuth({
+  provider: 'google',
+  options: { redirectTo: '/dashboard' },
+});
+
+const { data: session } = await auth.getSession();
+```
+
+### BetterAuthReactAdapter
+
+React hooks support:
+
+```typescript
+import { createAuthClient } from '@neondatabase/auth';
+import { BetterAuthReactAdapter } from '@neondatabase/auth/react/adapters';
+
+const auth = createAuthClient('https://your-auth-server.com', {
+  adapter: BetterAuthReactAdapter(),
+});
+
+function MyComponent() {
+  const session = auth.useSession();
+
+  if (session.isPending) return <div>Loading...</div>;
+  if (!session.data) return <div>Not logged in</div>;
+
+  return <div>Hello, {session.data.user.name}</div>;
+}
+```
+
+## Anonymous Access
+
+Enable RLS-based data access for unauthenticated users:
+
+```typescript
+const auth = createAuthClient('https://your-auth-server.com', {
+  allowAnonymous: true,
+});
+
+// Returns anonymous token if no user session exists
+const token = await auth.getJWTToken?.();
+```
+
+## API Reference
+
+### createAuthClient(url, config?)
+
+- `url` - Auth service URL (required)
+- `config.adapter` - Optional adapter factory (`SupabaseAuthAdapter()`, `BetterAuthReactAdapter()`)
+- `config.allowAnonymous` - Enable anonymous tokens (default: `false`)
+
+### Default API (Better Auth)
+
+- `signIn.email(credentials)` - Sign in with email/password
+- `signIn.social(options)` - Sign in with OAuth provider
+- `signUp.email(credentials)` - Create new user account
+- `signOut()` - Sign out current user
+- `getSession()` - Get current session
+
+### SupabaseAuthAdapter API
+
+- `signUp(credentials)` - Create user with Supabase-style options
+- `signInWithPassword(credentials)` - Email/password sign in
+- `signInWithOAuth(options)` - OAuth with Supabase-style options
+- `getSession()` - Returns `{ data: session }`
+- `getUser()` - Returns `{ data: user }`
+- `updateUser(attributes)` - Update user metadata
+- `resetPasswordForEmail(email, options)` - Password reset
+- `onAuthStateChange(callback)` - Auth state listener
+
+### BetterAuthReactAdapter API
+
+Same as default API, plus:
+- `useSession()` - React hook for session state
+
+## Performance
+
+- **Session Caching**: 60-second TTL, automatic JWT expiration handling
+- **Request Deduplication**: Concurrent calls share single network request
+- **Cold start**: ~200ms (single request) vs ~2000ms (without deduplication)
+
+## CSS for UI Components
+
+Choose based on your project setup:
+
+```css
+/* Without Tailwind - pre-built bundle (~47KB) */
+@import '@neondatabase/auth/ui/css';
+
+/* With Tailwind CSS v4 - theme tokens only */
+@import 'tailwindcss';
+@import '@neondatabase/auth/ui/tailwind';
+```
+
+Never import both paths - causes duplicate styles.
+
+## Optional
+
+- [Next.js Integration](https://github.com/neondatabase/neon-js/blob/main/packages/auth/NEXT-JS.md): Setup guide for Next.js 15+ with middleware and RSC support
+- [Better Auth Documentation](https://www.better-auth.com/docs): Underlying auth library documentation

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neondatabase/auth",
-  "version": "0.1.0-beta.2",
+  "version": "0.1.0-beta.20",
   "description": "TypeScript SDK for Neon Auth - authentication for PostgreSQL with multiple adapter support",
   "type": "module",
   "license": "Apache-2.0",
@@ -18,13 +18,13 @@
     "react",
     "nextjs"
   ],
-  "homepage": "https://github.com/neondatabase-labs/neon-js/tree/main/packages/auth#readme",
+  "homepage": "https://github.com/neondatabase/neon-js/tree/main/packages/auth#readme",
   "bugs": {
-    "url": "https://github.com/neondatabase-labs/neon-js/issues"
+    "url": "https://github.com/neondatabase/neon-js/issues"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/neondatabase-labs/neon-js.git",
+    "url": "git+https://github.com/neondatabase/neon-js.git",
     "directory": "packages/auth"
   },
   "funding": {
@@ -39,6 +39,10 @@
       "types": "./dist/index.d.mts",
       "default": "./dist/index.mjs"
     },
+    "./types": {
+      "types": "./dist/types/index.d.mts",
+      "default": "./dist/types/index.mjs"
+    },
     "./react": {
       "types": "./dist/react/index.d.mts",
       "default": "./dist/react/index.mjs"
@@ -67,6 +71,10 @@
       "types": "./dist/next/index.d.mts",
       "default": "./dist/next/index.mjs"
     },
+    "./next/server": {
+      "types": "./dist/next/server/index.d.mts",
+      "default": "./dist/next/server/index.mjs"
+    },
     "./ui/css": {
       "types": "./dist/ui/css.d.ts",
       "default": "./dist/ui/css.css"
@@ -76,7 +84,8 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "llms.txt"
   ],
   "publishConfig": {
     "access": "public"
@@ -95,19 +104,21 @@
     "release": "bun run build && bumpp --tag 'auth-v%s' && bun publish --tag latest"
   },
   "devDependencies": {
-    "msw": "2.6.8"
+    "@neondatabase/internal": "0.0.1",
+    "msw": "2.6.8",
+    "next": "16.0.6"
   },
   "dependencies": {
+    "@neondatabase/auth-ui": "0.1.0-alpha.10",
     "@supabase/auth-js": "2.79.0",
-    "better-auth": "1.4.6-beta.3",
-    "zod": "4.1.12",
+    "better-auth": "1.4.6",
     "jose": "6.1.2",
-    "@neondatabase/auth-ui": "0.1.0-alpha.3"
+    "zod": "4.1.12"
   },
   "peerDependencies": {
     "react": ">=18.0.0",
     "react-dom": ">=18.0.0",
-    "next": "^16.0.6"
+    "next": ">=16.0.6"
   },
   "peerDependenciesMeta": {
     "react": {