@neondatabase/neon-js 0.1.0-alpha.8 → 0.1.0-beta.1

package/README.md

@@ -1,5 +1,10 @@
 # @neondatabase/neon-js
 
+[![npm version](https://img.shields.io/npm/v/@neondatabase/neon-js.svg)](https://www.npmjs.com/package/@neondatabase/neon-js)
+[![npm downloads](https://img.shields.io/npm/dm/@neondatabase/neon-js.svg)](https://www.npmjs.com/package/@neondatabase/neon-js)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0%2B-blue.svg)](https://www.typescriptlang.org/)
+[![License](https://img.shields.io/npm/l/@neondatabase/neon-js.svg)](https://github.com/neondatabase-labs/neon-js/blob/main/LICENSE)
+
 The official TypeScript SDK for Neon, combining authentication and database querying in a familiar interface.
 
 ## Overview
@@ -8,7 +13,7 @@ The official TypeScript SDK for Neon, combining authentication and database quer
 
 **Key Features:**
 
-- **Integrated Authentication** - Multiple auth adapters (Supabase-compatible, Better Auth)
+- **Integrated Authentication** - Works out of the box with optional adapters (Supabase-compatible, React hooks)
 - **PostgreSQL Querying** - Full PostgREST client with type-safe queries
 - **High Performance** - Session caching, request deduplication
 - **Automatic Token Management** - Seamless token injection for database queries
@@ -25,14 +30,11 @@ bun add @neondatabase/neon-js
 
 ## Quick Start
 
-### Using SupabaseAuthAdapter (Supabase-compatible API)
-
 ```typescript
-import { createClient, SupabaseAuthAdapter } from '@neondatabase/neon-js';
+import { createClient } from '@neondatabase/neon-js';
 
 const client = createClient<Database>({
   auth: {
-    adapter: SupabaseAuthAdapter(),
     url: import.meta.env.VITE_NEON_AUTH_URL,
   },
   dataApi: {
@@ -40,27 +42,33 @@ const client = createClient<Database>({
   },
 });
 
-// Authenticate with Supabase-compatible API
-await client.auth.signInWithPassword({
+// Authenticate
+await client.auth.signIn.email({
   email: 'user@example.com',
   password: 'secure-password',
 });
 
 // Query database (token automatically injected)
-const { data: users, error } = await client
+const { data: users } = await client
   .from('users')
   .select('*')
   .eq('status', 'active');
 ```
 
-### Using BetterAuthVanillaAdapter (Direct Better Auth API)
+### Using Adapters
+
+You can optionally specify an adapter for different API styles:
+
+#### SupabaseAuthAdapter (Supabase-compatible API)
+
+Use this adapter if you're migrating from Supabase or prefer the Supabase API style:
 
 ```typescript
-import { createClient, BetterAuthVanillaAdapter } from '@neondatabase/neon-js';
+import { createClient, SupabaseAuthAdapter } from '@neondatabase/neon-js';
 
 const client = createClient<Database>({
   auth: {
-    adapter: BetterAuthVanillaAdapter(),
+    adapter: SupabaseAuthAdapter(),
     url: import.meta.env.VITE_NEON_AUTH_URL,
   },
   dataApi: {
@@ -68,22 +76,22 @@ const client = createClient<Database>({
   },
 });
 
-// Authenticate with Better Auth API
-await client.auth.signIn.email({
+// Supabase-compatible API
+await client.auth.signInWithPassword({
   email: 'user@example.com',
   password: 'secure-password',
 });
 
-// Query database (token automatically injected)
-const { data: users } = await client
-  .from('users')
-  .select('*');
+const { data: session } = await client.auth.getSession();
 ```
 
-### Using BetterAuthReactAdapter (Better Auth with React Hooks)
+#### BetterAuthReactAdapter (React Hooks)
+
+Use this adapter in React applications to get access to hooks like `useSession`:
 
 ```typescript
-import { createClient, BetterAuthReactAdapter } from '@neondatabase/neon-js';
+import { createClient } from '@neondatabase/neon-js';
+import { BetterAuthReactAdapter } from '@neondatabase/neon-js/auth/react/adapters';
 
 const client = createClient<Database>({
   auth: {
@@ -108,22 +116,7 @@ function MyComponent() {
 
 ## Authentication
 
-### Sign Up (SupabaseAuthAdapter)
-
-```typescript
-await client.auth.signUp({
-  email: 'user@example.com',
-  password: 'secure-password',
-  options: {
-    data: {
-      name: 'John Doe',
-      avatar_url: 'https://example.com/avatar.jpg',
-    },
-  },
-});
-```
-
-### Sign Up (BetterAuth Adapters)
+### Sign Up
 
 ```typescript
 await client.auth.signUp.email({
@@ -133,25 +126,7 @@ await client.auth.signUp.email({
 });
 ```
 
-### Sign In (SupabaseAuthAdapter)
-
-```typescript
-// Email & Password
-await client.auth.signInWithPassword({
-  email: 'user@example.com',
-  password: 'secure-password',
-});
-
-// OAuth
-await client.auth.signInWithOAuth({
-  provider: 'google',
-  options: {
-    redirectTo: '/dashboard',
-  },
-});
-```
-
-### Sign In (BetterAuth Adapters)
+### Sign In
 
 ```typescript
 // Email & Password
@@ -167,45 +142,49 @@ await client.auth.signIn.social({
 });
 ```
 
-### Session Management (SupabaseAuthAdapter)
+### Session Management
 
 ```typescript
 // Get current session
-const { data: session } = await client.auth.getSession();
-
-// Get current user
-const { data: user } = await client.auth.getUser();
-
-// Update user
-await client.auth.updateUser({
-  data: {
-    name: 'Jane Doe',
-  },
-});
+const session = await client.auth.getSession();
 
 // Sign out
 await client.auth.signOut();
 ```
 
-### Session Management (BetterAuth Adapters)
+### SupabaseAuthAdapter API
+
+When using `SupabaseAuthAdapter`, you get access to the Supabase-compatible API:
 
 ```typescript
-// Get current session
-const session = await client.auth.getSession();
+// Sign up with metadata
+await client.auth.signUp({
+  email: 'user@example.com',
+  password: 'secure-password',
+  options: {
+    data: { name: 'John Doe' },
+  },
+});
 
-// Sign out
-await client.auth.signOut();
-```
+// Sign in
+await client.auth.signInWithPassword({
+  email: 'user@example.com',
+  password: 'secure-password',
+});
 
-### Auth State Changes (SupabaseAuthAdapter)
+// OAuth
+await client.auth.signInWithOAuth({
+  provider: 'google',
+  options: { redirectTo: '/dashboard' },
+});
 
-```typescript
+// Session with data wrapper
+const { data: session } = await client.auth.getSession();
+const { data: user } = await client.auth.getUser();
+
+// Auth state changes
 client.auth.onAuthStateChange((event, session) => {
-  if (event === 'SIGNED_IN') {
-    console.log('User signed in:', session?.user);
-  } else if (event === 'SIGNED_OUT') {
-    console.log('User signed out');
-  }
+  console.log(event, session);
 });
 ```
 
@@ -296,12 +275,11 @@ const { data } = await client
 ### Client Options
 
 ```typescript
-import { createClient, SupabaseAuthAdapter } from '@neondatabase/neon-js';
+import { createClient } from '@neondatabase/neon-js';
 
 const client = createClient({
   // Auth configuration
   auth: {
-    adapter: SupabaseAuthAdapter(),
     url: 'https://your-auth-server.neon.tech/auth',
   },
 
@@ -333,11 +311,10 @@ NEON_DATA_API_URL=https://your-data-api.neon.tech/rest/v1
 ```
 
 ```typescript
-import { createClient, SupabaseAuthAdapter } from '@neondatabase/neon-js';
+import { createClient } from '@neondatabase/neon-js';
 
 const client = createClient({
   auth: {
-    adapter: SupabaseAuthAdapter(),
     url: process.env.NEON_AUTH_URL!,
   },
   dataApi: {
@@ -346,6 +323,24 @@ const client = createClient({
 });
 ```
 
+## UI Component Styles
+
+If you're using `@neondatabase/auth-ui` components with the SDK, CSS is conveniently available:
+
+| Export | Use Case |
+|--------|----------|
+| `@neondatabase/neon-js/ui/css` | Pre-built styles (~47KB) |
+| `@neondatabase/neon-js/ui/tailwind` | Tailwind-ready CSS |
+
+```css
+/* Without Tailwind */
+@import '@neondatabase/neon-js/ui/css';
+
+/* With Tailwind CSS v4 */
+@import 'tailwindcss';
+@import '@neondatabase/neon-js/ui/tailwind';
+```
+
 ## TypeScript
 
 Generate TypeScript types from your database schema:
@@ -358,11 +353,10 @@ Use generated types for full type safety:
 
 ```typescript
 import type { Database } from './types/database';
-import { createClient, SupabaseAuthAdapter } from '@neondatabase/neon-js';
+import { createClient } from '@neondatabase/neon-js';
 
 const client = createClient<Database>({
   auth: {
-    adapter: SupabaseAuthAdapter(),
     url: process.env.NEON_AUTH_URL!,
   },
   dataApi: {
@@ -450,11 +444,10 @@ if (error) {
 
 ```typescript
 // app/lib/neon.ts
-import { createClient, SupabaseAuthAdapter } from '@neondatabase/neon-js';
+import { createClient } from '@neondatabase/neon-js';
 
 export const neon = createClient({
   auth: {
-    adapter: SupabaseAuthAdapter(),
     url: process.env.NEON_AUTH_URL!,
   },
   dataApi: {
@@ -474,7 +467,8 @@ export async function GET() {
 ### React Hook with BetterAuthReactAdapter
 
 ```typescript
-import { createClient, BetterAuthReactAdapter } from '@neondatabase/neon-js';
+import { createClient } from '@neondatabase/neon-js';
+import { BetterAuthReactAdapter } from '@neondatabase/neon-js/auth/react/adapters';
 
 const client = createClient({
   auth: {
@@ -503,7 +497,7 @@ export function useAuth() {
 
 This package combines two underlying packages:
 
-- [`@neondatabase/neon-auth`](../neon-auth) - Authentication adapters (can be used standalone)
+- [`@neondatabase/auth`](../auth) - Authentication adapters (can be used standalone)
 - [`@neondatabase/postgrest-js`](../postgrest-js) - PostgreSQL client (can be used standalone)
 
 ## Migration from Previous Version
@@ -541,7 +535,7 @@ const client = createClient({
 ## Support
 
 - [GitHub Issues](https://github.com/neondatabase/neon-js/issues)
-- [Neon Community Discord](https://discord.gg/neon)
+- [Neon Community Discord](https://discord.gg/H24eC2UN)
 
 ## License
 

package/dist/auth/index.d.mts

@@ -0,0 +1 @@
+export * from "@neondatabase/auth";

package/dist/auth/index.mjs

@@ -0,0 +1,3 @@
+export * from "@neondatabase/auth"
+
+export {  };

package/dist/auth/next/index.d.mts

@@ -0,0 +1 @@
+export * from "@neondatabase/auth/next";

package/dist/auth/next/index.mjs

@@ -0,0 +1,3 @@
+export * from "@neondatabase/auth/next"
+
+export {  };

package/dist/auth/react/adapters/index.d.mts

@@ -0,0 +1 @@
+export * from "@neondatabase/auth/react/adapters";

package/dist/auth/react/adapters/index.mjs

@@ -0,0 +1,3 @@
+export * from "@neondatabase/auth/react/adapters"
+
+export {  };

package/dist/auth/react/index.d.mts

@@ -0,0 +1 @@
+export * from "@neondatabase/auth/react";

package/dist/auth/react/index.mjs

@@ -0,0 +1,3 @@
+export * from "@neondatabase/auth/react"
+
+export {  };

package/dist/auth/react/ui/index.d.mts

@@ -0,0 +1,2 @@
+'use client';
+export * from "@neondatabase/auth/react/ui";

package/dist/auth/react/ui/index.mjs

@@ -0,0 +1,4 @@
+'use client';
+export * from "@neondatabase/auth/react/ui"
+
+export {  };

package/dist/auth/react/ui/server.d.mts

@@ -0,0 +1 @@
+export * from "@neondatabase/auth/react/ui/server";

package/dist/auth/react/ui/server.mjs

@@ -0,0 +1,3 @@
+export * from "@neondatabase/auth/react/ui/server"
+
+export {  };

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

@@ -0,0 +1 @@
+export * from "@neondatabase/auth/vanilla/adapters";

package/dist/auth/vanilla/adapters/index.mjs

@@ -0,0 +1,3 @@
+export * from "@neondatabase/auth/vanilla/adapters"
+
+export {  };

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

@@ -0,0 +1 @@
+export * from "@neondatabase/auth/vanilla";

package/dist/auth/vanilla/index.mjs

@@ -0,0 +1,3 @@
+export * from "@neondatabase/auth/vanilla"
+
+export {  };