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

package/dist/index.d.mts

@@ -1,99 +1,6 @@
-import { r as SupportedBetterAuthClientPlugins } from "./adapter-core-C12KoaiU.mjs";
-import { r as BetterAuthReactAdapterInstance } from "./better-auth-react-adapter-BXL48HIU.mjs";
-import { r as SupabaseAuthAdapterInstance, s as BetterAuthVanillaAdapterInstance } from "./supabase-adapter-crabDnl2.mjs";
-import { createAuthClient as createAuthClient$1 } from "better-auth/react";
-import { createAuthClient as createAuthClient$2 } from "better-auth/client";
-
-//#region src/neon-auth.d.ts
-
-/**
- * Type representing the Better Auth React client
- */
-type ReactBetterAuthClient = ReturnType<typeof createAuthClient$1<{
-  plugins: SupportedBetterAuthClientPlugins;
-}>>;
-/**`
- * Type representing the Better Auth Vanilla client
- */
-type VanillaBetterAuthClient = ReturnType<typeof createAuthClient$2<{
-  plugins: SupportedBetterAuthClientPlugins;
-}>>;
-/**
- * Union type of all supported auth adapter instances
- */
-type NeonAuthAdapter = BetterAuthVanillaAdapterInstance | BetterAuthReactAdapterInstance | SupabaseAuthAdapterInstance;
-/**
- * Configuration for createAuthClient
- */
-interface NeonAuthConfig<T extends NeonAuthAdapter> {
-  /** The adapter builder to use. Defaults to BetterAuthVanillaAdapter() if not specified. */
-  adapter?: (url: string) => T;
-}
-/**
- * Resolves the public API type for an adapter.
- * - SupabaseAuthAdapter: exposes its own methods directly (Supabase-compatible API)
- * - BetterAuth adapters: expose the Better Auth client directly
- */
-type NeonAuthPublicApi<T extends NeonAuthAdapter> = T extends BetterAuthVanillaAdapterInstance ? VanillaBetterAuthClient : T extends BetterAuthReactAdapterInstance ? ReactBetterAuthClient : T;
-/**
- * NeonAuth type - combines base functionality with the appropriate public API
- * This is the return type of createAuthClient()
- *
- * For SupabaseAuthAdapter: exposes Supabase-compatible methods (signInWithPassword, getSession, etc.)
- * For BetterAuth adapters: exposes the Better Auth client directly (signIn.email, signUp.email, etc.)
- */
-type NeonAuth<T extends NeonAuthAdapter> = {
-  adapter: NeonAuthPublicApi<T>;
-  getJWTToken: () => Promise<string | null>;
-};
-/**
- * Create a NeonAuth instance that exposes the appropriate API based on the adapter.
- *
- * @param url - The auth service URL (e.g., 'https://auth.example.com')
- * @param config - Configuration with adapter builder
- * @returns NeonAuth instance with the adapter's API exposed directly
- *
- * @example SupabaseAuthAdapter - Supabase-compatible API
- * ```typescript
- * import { createAuthClient, SupabaseAuthAdapter } from '@neondatabase/auth';
- *
- * const auth = createAuthClient('https://auth.example.com', {
- *   adapter: SupabaseAuthAdapter(),
- * });
- *
- * // Supabase-compatible methods
- * await auth.signInWithPassword({ email, password });
- * await auth.getSession();
- * ```
- *
- * @example BetterAuthVanillaAdapter - Direct Better Auth API
- * ```typescript
- * import { createAuthClient, BetterAuthVanillaAdapter } from '@neondatabase/auth';
- *
- * const auth = createAuthClient('https://auth.example.com', {
- *   adapter: BetterAuthVanillaAdapter(),
- * });
- *
- * // Direct Better Auth API access
- * await auth.signIn.email({ email, password });
- * await auth.signUp.email({ email, password, name: 'John' });
- * await auth.getSession();
- * ```
- *
- * @example BetterAuthReactAdapter - Better Auth with React hooks
- * ```typescript
- * import { createAuthClient, BetterAuthReactAdapter } from '@neondatabase/auth';
- *
- * const auth = createAuthClient('https://auth.example.com', {
- *   adapter: BetterAuthReactAdapter(),
- * });
- *
- * // Direct Better Auth API with React hooks
- * await auth.signIn.email({ email, password });
- * const session = auth.useSession(); // React hook
- * ```
- */
-declare function createInternalNeonAuth<T extends NeonAuthAdapter = BetterAuthVanillaAdapterInstance>(url: string, config?: NeonAuthConfig<T>): NeonAuth<T>;
-declare function createAuthClient<T extends NeonAuthAdapter = BetterAuthVanillaAdapterInstance>(url: string, config?: NeonAuthConfig<T>): NeonAuthPublicApi<T>;
-//#endregion
+import "./better-auth-types-BUiggBfa.mjs";
+import "./adapter-core-23fYTUxT.mjs";
+import "./better-auth-react-adapter-QFe5RtaM.mjs";
+import "./supabase-adapter-Dr-pKvPt.mjs";
+import { a as ReactBetterAuthClient, c as createInternalNeonAuth, i as NeonAuthPublicApi, n as NeonAuthAdapter, o as VanillaBetterAuthClient, r as NeonAuthConfig, s as createAuthClient, t as NeonAuth } from "./neon-auth-CDYpC_O1.mjs";
 export { type NeonAuth, type NeonAuthAdapter, type NeonAuthConfig, type NeonAuthPublicApi, type ReactBetterAuthClient, type VanillaBetterAuthClient, createAuthClient, createInternalNeonAuth };

package/dist/index.mjs

@@ -1,3 +1,4 @@
-import { n as createInternalNeonAuth, t as createAuthClient } from "./neon-auth-C9XTFffv.mjs";
+import "./adapter-core-8s6XdCco.mjs";
+import { n as createInternalNeonAuth, t as createAuthClient } from "./neon-auth-2f58U8_-.mjs";
 
 export { createAuthClient, createInternalNeonAuth };

package/dist/middleware-C7jHeulu.mjs

@@ -0,0 +1,303 @@
+import { r as NEON_AUTH_COOKIE_PREFIX, s as NEON_AUTH_SESSION_VERIFIER_PARAM_NAME } from "./constants-2bpp2_-f.mjs";
+import { parseCookies, parseSetCookieHeader } from "better-auth/cookies";
+import { NextRequest, NextResponse } from "next/server";
+import { cookies, headers } from "next/headers";
+
+//#region src/next/errors.ts
+const ERRORS = { MISSING_AUTH_BASE_URL: "Missing environment variable: NEON_AUTH_BASE_URL. \n You must provide the auth url of your Neon Auth instance in environment variables" };
+
+//#endregion
+//#region src/utils/cookies.ts
+/**
+* Extract the Neon Auth cookies from the request headers.
+* Only returns cookies that start with the NEON_AUTH_COOKIE_PREFIX.
+*
+* @param headers - The request headers or cookie header string.
+* @returns The cookie string with all Neon Auth cookies (e.g., "name=value; name2=value2").
+*/
+const extractNeonAuthCookies = (headers$1) => {
+	const cookieHeader = typeof headers$1 === "string" ? headers$1 : headers$1.get("cookie");
+	if (!cookieHeader) return "";
+	const parsedCookies = parseCookies(cookieHeader);
+	const result = [];
+	for (const [name, value] of parsedCookies.entries()) if (name.startsWith(NEON_AUTH_COOKIE_PREFIX)) result.push(`${name}=${value}`);
+	return result.join("; ");
+};
+/**
+* Parses the `set-cookie` header from Neon Auth response into a list of cookies.
+*
+* @param setCookieHeader - The `set-cookie` header from Neon Auth response.
+* @returns The list of parsed cookies with their options.
+*/
+const parseSetCookies = (setCookieHeader) => {
+	const parsedCookies = parseSetCookieHeader(setCookieHeader);
+	const cookies$1 = [];
+	for (const entry of parsedCookies.entries()) {
+		const [name, parsedCookie] = entry;
+		cookies$1.push({
+			name,
+			value: decodeURIComponent(parsedCookie.value),
+			path: parsedCookie.path,
+			maxAge: parsedCookie["max-age"] ?? parsedCookie.maxAge,
+			httpOnly: parsedCookie.httponly ?? true,
+			secure: parsedCookie.secure ?? true,
+			sameSite: parsedCookie.samesite ?? "lax",
+			partitioned: parsedCookie.partitioned
+		});
+	}
+	return cookies$1;
+};
+
+//#endregion
+//#region src/next/constants.ts
+const NEON_AUTH_SESSION_COOKIE_NAME = `${NEON_AUTH_COOKIE_PREFIX}.session_token`;
+const NEON_AUTH_SESSION_CHALLENGE_COOKIE_NAME = `${NEON_AUTH_COOKIE_PREFIX}.session_challange`;
+const NEON_AUTH_HEADER_MIDDLEWARE_NAME = "X-Neon-Auth-Next-Middleware";
+
+//#endregion
+//#region src/next/handler/request.ts
+const PROXY_HEADERS = [
+	"user-agent",
+	"authorization",
+	"referer",
+	"content-type"
+];
+const handleAuthRequest = async (baseUrl, request, path) => {
+	const headers$1 = prepareRequestHeaders(request);
+	const body = await parseRequestBody(request);
+	try {
+		const upstreamURL = getUpstreamURL(baseUrl, path, { originalUrl: new URL(request.url) });
+		return await fetch(upstreamURL.toString(), {
+			method: request.method,
+			headers: headers$1,
+			body
+		});
+	} catch (error) {
+		const message = error instanceof Error ? error.message : "Internal Server Error";
+		console.error(`[AuthError] ${message}`, error);
+		return new Response(`[AuthError] ${message}`, { status: 500 });
+	}
+};
+const getUpstreamURL = (baseUrl, path, { originalUrl }) => {
+	const url = new URL(`${baseUrl}/${path}`);
+	if (originalUrl) {
+		url.search = originalUrl.search;
+		return url;
+	}
+	return url;
+};
+const prepareRequestHeaders = (request) => {
+	const headers$1 = new Headers();
+	for (const header of PROXY_HEADERS) if (request.headers.get(header)) headers$1.set(header, request.headers.get(header));
+	headers$1.set("Origin", getOrigin(request));
+	headers$1.set("Cookie", extractNeonAuthCookies(request.headers));
+	headers$1.set(NEON_AUTH_HEADER_MIDDLEWARE_NAME, "true");
+	return headers$1;
+};
+const getOrigin = (request) => {
+	return request.headers.get("origin") || request.headers.get("referer")?.split("/").slice(0, 3).join("/") || new URL(request.url).origin;
+};
+const parseRequestBody = async (request) => {
+	if (request.body) return request.text();
+};
+
+//#endregion
+//#region src/next/handler/response.ts
+const RESPONSE_HEADERS_ALLOWLIST = [
+	"content-type",
+	"content-length",
+	"content-encoding",
+	"transfer-encoding",
+	"connection",
+	"date",
+	"set-cookie",
+	"set-auth-jwt",
+	"set-auth-token",
+	"x-neon-ret-request-id"
+];
+const handleAuthResponse = async (response) => {
+	return new Response(response.body, {
+		status: response.status,
+		statusText: response.statusText,
+		headers: prepareResponseHeaders(response)
+	});
+};
+const prepareResponseHeaders = (response) => {
+	const headers$1 = new Headers();
+	for (const header of RESPONSE_HEADERS_ALLOWLIST) {
+		const value = response.headers.get(header);
+		if (value) headers$1.set(header, value);
+	}
+	return headers$1;
+};
+
+//#endregion
+//#region src/next/handler/index.ts
+/**
+* 
+* An API route handler to handle the auth requests from the client and proxy them to the Neon Auth.
+* 
+* @returns A Next.js API handler functions those can be used in a Next.js route.
+*
+* @example
+* Mount the `authApiHandler` to an API route. Create a route file inside `/api/auth/[...all]/route.ts` directory. 
+*  And add the following code:
+* 
+* ```ts 
+* // app/api/auth/[...all]/route.ts
+* import { authApiHandler } from '@neondatabase/auth/next';
+* 
+* export const { GET, POST } = authApiHandler();
+* ```
+*/
+function authApiHandler() {
+	const baseURL = process.env.NEON_AUTH_BASE_URL;
+	if (!baseURL) throw new Error(ERRORS.MISSING_AUTH_BASE_URL);
+	const handler = async (request, { params }) => {
+		return await handleAuthResponse(await handleAuthRequest(baseURL, request, (await params).path.join("/")));
+	};
+	return {
+		GET: handler,
+		POST: handler,
+		PUT: handler,
+		DELETE: handler,
+		PATCH: handler
+	};
+}
+
+//#endregion
+//#region src/next/auth/cookies.ts
+/**
+* Extract the Neon Auth cookies from the response headers.
+* @deprecated Use parseSetCookies instead
+*/
+const extractResponseCookies = (headers$1) => {
+	const cookieHeader = headers$1.get("set-cookie");
+	if (!cookieHeader) return [];
+	return cookieHeader.split(", ").map((c) => c.trim());
+};
+
+//#endregion
+//#region src/next/middleware/oauth.ts
+const needsSessionVerification = (request) => {
+	const hasVerifier = request.nextUrl.searchParams.has(NEON_AUTH_SESSION_VERIFIER_PARAM_NAME);
+	const hasChallenge = request.cookies.get(NEON_AUTH_SESSION_CHALLENGE_COOKIE_NAME);
+	return hasVerifier && hasChallenge;
+};
+const exchangeOAuthToken = async (request, baseUrl) => {
+	const url = request.nextUrl;
+	const verifier = url.searchParams.get(NEON_AUTH_SESSION_VERIFIER_PARAM_NAME);
+	const challenge = request.cookies.get(NEON_AUTH_SESSION_CHALLENGE_COOKIE_NAME);
+	if (!verifier || !challenge) return null;
+	const response = await handleAuthResponse(await handleAuthRequest(baseUrl, new Request(request.url, {
+		method: "GET",
+		headers: request.headers
+	}), "get-session"));
+	if (response.ok) {
+		const headers$1 = new Headers();
+		const cookies$1 = extractResponseCookies(response.headers);
+		for (const cookie of cookies$1) headers$1.append("Set-Cookie", cookie);
+		url.searchParams.delete(NEON_AUTH_SESSION_VERIFIER_PARAM_NAME);
+		return NextResponse.redirect(url, { headers: headers$1 });
+	}
+	return null;
+};
+
+//#endregion
+//#region src/next/env-variables.ts
+const NEON_AUTH_BASE_URL = process.env.NEON_AUTH_BASE_URL;
+
+//#endregion
+//#region src/next/auth/session.ts
+/**
+* A utility function to be used in react server components fetch the session details from the Neon Auth API, if session token is available in cookie.
+*
+* @returns - `{ session: Session, user: User }` | `{ session: null, user: null}`.
+*
+* @example
+* ```ts
+* import { neonAuth } from "@neondatabase/auth/next"
+*
+* const { session, user } = await neonAuth()
+* ```
+*/
+const neonAuth = async () => {
+	return await fetchSession();
+};
+/**
+* A utility function to fetch the session details from the Neon Auth API, if session token is available in cookie.
+*
+* @returns - `{ session: Session, user: User }` | `{ session: null, user: null}`.
+*/
+const fetchSession = async () => {
+	const baseUrl = NEON_AUTH_BASE_URL;
+	const requestHeaders = await headers();
+	const upstreamURL = getUpstreamURL(baseUrl, "get-session", { originalUrl: new URL("get-session", baseUrl) });
+	const response = await fetch(upstreamURL.toString(), {
+		method: "GET",
+		headers: { Cookie: extractNeonAuthCookies(requestHeaders) }
+	});
+	const body = await response.json();
+	const cookieHeader = response.headers.get("set-cookie");
+	if (cookieHeader) {
+		const cookieStore = await cookies();
+		parseSetCookies(cookieHeader).map((cookie) => {
+			cookieStore.set(cookie.name, cookie.value, cookie);
+		});
+	}
+	if (!response.ok || body === null) return {
+		session: null,
+		user: null
+	};
+	return {
+		session: body.session,
+		user: body.user
+	};
+};
+
+//#endregion
+//#region src/next/middleware/index.ts
+const SKIP_ROUTES = [
+	"/api/auth",
+	"/auth/callback",
+	"/auth/sign-in",
+	"/auth/sign-up",
+	"/auth/magic-link",
+	"/auth/email-otp",
+	"/auth/forgot-password"
+];
+/**
+* A Next.js middleware to protect routes from unauthenticated requests and refresh the session if required.
+*
+* @param loginUrl - The URL to redirect to when the user is not authenticated.
+* @returns A middleware function that can be used in the Next.js app.
+*
+* @example
+* ```ts
+* import { neonAuthMiddleware } from "@neondatabase/auth/next"
+*
+* export default neonAuthMiddleware({
+*   loginUrl: '/auth/sign-in',
+* });
+* ```
+*/
+function neonAuthMiddleware({ loginUrl = "/auth/sign-in" }) {
+	const baseUrl = NEON_AUTH_BASE_URL;
+	if (!baseUrl) throw new Error(ERRORS.MISSING_AUTH_BASE_URL);
+	return async (request) => {
+		const { pathname } = request.nextUrl;
+		if (pathname.startsWith(loginUrl)) return NextResponse.next();
+		if (needsSessionVerification(request)) {
+			const response = await exchangeOAuthToken(request, baseUrl);
+			if (response !== null) return response;
+		}
+		if (SKIP_ROUTES.some((route) => pathname.startsWith(route))) return NextResponse.next();
+		if ((await fetchSession()).session === null) return NextResponse.redirect(new URL(loginUrl, request.url));
+		const reqHeaders = new Headers(request.headers);
+		reqHeaders.set(NEON_AUTH_HEADER_MIDDLEWARE_NAME, "true");
+		return NextResponse.next({ request: { headers: reqHeaders } });
+	};
+}
+
+//#endregion
+export { parseSetCookies as a, extractNeonAuthCookies as i, neonAuth as n, authApiHandler as r, neonAuthMiddleware as t };

package/dist/{neon-auth-C9XTFffv.mjs → neon-auth-2f58U8_-.mjs}

@@ -1,4 +1,4 @@
-import { n as BetterAuthVanillaAdapter } from "./supabase-adapter-ggmqWgPe.mjs";
+import { n as BetterAuthVanillaAdapter } from "./supabase-adapter-BYMJSxOT.mjs";
 
 //#region src/neon-auth.ts
 /**
@@ -49,13 +49,16 @@ import { n as BetterAuthVanillaAdapter } from "./supabase-adapter-ggmqWgPe.mjs";
 * ```
 */
 function createInternalNeonAuth(url, config) {
-	const adapter = (config?.adapter ?? BetterAuthVanillaAdapter())(url);
+	const adapterBuilder = config?.adapter ?? BetterAuthVanillaAdapter();
+	const { fetchOptions } = config ?? {};
+	const adapter = adapterBuilder(url, fetchOptions);
+	const allowAnonymous = config?.allowAnonymous ?? false;
 	if (!(typeof adapter.initialize === "function")) return {
-		getJWTToken: adapter.getJWTToken.bind(adapter),
+		getJWTToken: () => adapter.getJWTToken(allowAnonymous),
 		adapter: adapter.getBetterAuthInstance()
 	};
 	return {
-		getJWTToken: adapter.getJWTToken.bind(adapter),
+		getJWTToken: () => adapter.getJWTToken(allowAnonymous),
 		adapter
 	};
 }

package/dist/neon-auth-CDYpC_O1.d.mts

@@ -0,0 +1,107 @@
+import { r as SupportedBetterAuthClientPlugins } from "./adapter-core-23fYTUxT.mjs";
+import { n as BetterAuthReactAdapterInstance } from "./better-auth-react-adapter-QFe5RtaM.mjs";
+import { r as SupabaseAuthAdapterInstance, s as BetterAuthVanillaAdapterInstance } from "./supabase-adapter-Dr-pKvPt.mjs";
+import { createAuthClient } from "better-auth/react";
+import { createAuthClient as createAuthClient$1 } from "better-auth/client";
+
+//#region src/neon-auth.d.ts
+
+/**
+ * Type representing the Better Auth React client
+ */
+type ReactBetterAuthClient = ReturnType<typeof createAuthClient<{
+  plugins: SupportedBetterAuthClientPlugins;
+}>>;
+/**
+ * Type representing the Better Auth Vanilla client
+ */
+type VanillaBetterAuthClient = ReturnType<typeof createAuthClient$1<{
+  plugins: SupportedBetterAuthClientPlugins;
+}>>;
+/**
+ * Union type of all supported auth adapter instances
+ */
+type NeonAuthAdapter = BetterAuthVanillaAdapterInstance | BetterAuthReactAdapterInstance | SupabaseAuthAdapterInstance;
+/**
+ * Configuration for createAuthClient
+ */
+interface NeonAuthConfig<T extends NeonAuthAdapter> {
+  /** The adapter builder to use. Defaults to BetterAuthVanillaAdapter() if not specified. */
+  adapter?: (url: string, fetchOptions?: {
+    headers?: Record<string, string>;
+  }) => T;
+  /**
+   * When true, automatically uses an anonymous token when no user session exists.
+   * This enables RLS-based data access for users with the anonymous role.
+   * @default false
+   */
+  allowAnonymous?: boolean;
+}
+/**
+ * Resolves the public API type for an adapter.
+ * - SupabaseAuthAdapter: exposes its own methods directly (Supabase-compatible API)
+ * - BetterAuth adapters: expose the Better Auth client directly
+ */
+type NeonAuthPublicApi<T extends NeonAuthAdapter> = T extends BetterAuthVanillaAdapterInstance ? VanillaBetterAuthClient : T extends BetterAuthReactAdapterInstance ? ReactBetterAuthClient : T;
+/**
+ * NeonAuth type - combines base functionality with the appropriate public API
+ * This is the return type of createAuthClient()
+ *
+ * For SupabaseAuthAdapter: exposes Supabase-compatible methods (signInWithPassword, getSession, etc.)
+ * For BetterAuth adapters: exposes the Better Auth client directly (signIn.email, signUp.email, etc.)
+ */
+type NeonAuth<T extends NeonAuthAdapter> = {
+  adapter: NeonAuthPublicApi<T>;
+  getJWTToken: () => Promise<string | null>;
+};
+/**
+ * Create a NeonAuth instance that exposes the appropriate API based on the adapter.
+ *
+ * @param url - The auth service URL (e.g., 'https://auth.example.com')
+ * @param config - Configuration with adapter builder
+ * @returns NeonAuth instance with the adapter's API exposed directly
+ *
+ * @example SupabaseAuthAdapter - Supabase-compatible API
+ * ```typescript
+ * import { createAuthClient, SupabaseAuthAdapter } from '@neondatabase/auth';
+ *
+ * const auth = createAuthClient('https://auth.example.com', {
+ *   adapter: SupabaseAuthAdapter(),
+ * });
+ *
+ * // Supabase-compatible methods
+ * await auth.signInWithPassword({ email, password });
+ * await auth.getSession();
+ * ```
+ *
+ * @example BetterAuthVanillaAdapter - Direct Better Auth API
+ * ```typescript
+ * import { createAuthClient, BetterAuthVanillaAdapter } from '@neondatabase/auth';
+ *
+ * const auth = createAuthClient('https://auth.example.com', {
+ *   adapter: BetterAuthVanillaAdapter(),
+ * });
+ *
+ * // Direct Better Auth API access
+ * await auth.signIn.email({ email, password });
+ * await auth.signUp.email({ email, password, name: 'John' });
+ * await auth.getSession();
+ * ```
+ *
+ * @example BetterAuthReactAdapter - Better Auth with React hooks
+ * ```typescript
+ * import { createAuthClient, BetterAuthReactAdapter } from '@neondatabase/auth';
+ *
+ * const auth = createAuthClient('https://auth.example.com', {
+ *   adapter: BetterAuthReactAdapter(),
+ * });
+ *
+ * // Direct Better Auth API with React hooks
+ * await auth.signIn.email({ email, password });
+ * const session = auth.useSession(); // React hook
+ * ```
+ */
+declare function createInternalNeonAuth<T extends NeonAuthAdapter = BetterAuthVanillaAdapterInstance>(url: string, config?: NeonAuthConfigInternal<T>): NeonAuth<T>;
+declare function createAuthClient$2<T extends NeonAuthAdapter = BetterAuthVanillaAdapterInstance>(url: string, config?: NeonAuthConfig<T>): NeonAuthPublicApi<T>;
+//#endregion
+export { ReactBetterAuthClient as a, createInternalNeonAuth as c, NeonAuthPublicApi as i, NeonAuthAdapter as n, VanillaBetterAuthClient as o, NeonAuthConfig as r, createAuthClient$2 as s, NeonAuth as t };