@neondatabase/auth 0.3.0-beta → 0.4.1-beta

package/README.md

@@ -269,19 +269,34 @@ See the [Next.js Setup Guide](./NEXT-JS.md) for comprehensive documentation incl
 
 ## UI Components
 
-Pre-built login forms and auth pages are included. No extra installation needed.
+Pre-built login forms and auth pages live in `@neondatabase/auth-ui`. The
+legacy `@neondatabase/auth/react/ui` and `@neondatabase/auth/ui/*` entrypoints
+still work for compatibility, but they are deprecated and will be removed in
+the next major version.
+
+To migrate existing imports, run:
+
+```bash
+npx -p @neondatabase/auth neon-auth-codemod --write <path>
+```
 
 ### 1. Import CSS
 
+Install the UI package alongside `@neondatabase/auth`:
+
+```bash
+npm install @neondatabase/auth-ui
+```
+
 **Without Tailwind CSS:**
 ```typescript
-import '@neondatabase/auth/ui/css';
+import '@neondatabase/auth-ui/css';
 ```
 
 **With Tailwind CSS v4:**
 ```css
 @import 'tailwindcss';
-@import '@neondatabase/auth/ui/tailwind';
+@import '@neondatabase/auth-ui/tailwind';
 ```
 
 ### 2. Setup Provider
@@ -289,9 +304,9 @@ import '@neondatabase/auth/ui/css';
 ```typescript
 "use client"
 
-import { NeonAuthUIProvider } from "@neondatabase/auth/react/ui"
+import { NeonAuthUIProvider } from "@neondatabase/auth-ui"
 import { createAuthClient } from "@neondatabase/auth"
-import "@neondatabase/auth/ui/css"
+import "@neondatabase/auth-ui/css"
 
 const authClient = createAuthClient('https://your-auth-url.com')
 
@@ -311,7 +326,7 @@ export function AuthProvider({ children }) {
 Use `AuthView` to render complete auth flows based on the URL path:
 
 ```typescript
-import { AuthView } from "@neondatabase/auth/react/ui"
+import { AuthView } from "@neondatabase/auth-ui"
 
 // Renders sign-in, sign-up, forgot-password, etc. based on path
 <AuthView path="sign-in" />
@@ -320,7 +335,7 @@ import { AuthView } from "@neondatabase/auth/react/ui"
 **Option B: Individual Components**
 
 ```typescript
-import { SignInForm, UserButton } from "@neondatabase/auth/react/ui"
+import { SignInForm, UserButton } from "@neondatabase/auth-ui"
 
 <SignInForm />
 <UserButton />

package/codemods/migrate-auth-ui-imports.mjs

@@ -0,0 +1,439 @@
+#!/usr/bin/env node
+/* eslint-disable no-undef */
+import { existsSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+// eslint-disable-next-line unicorn/import-style
+import { dirname, extname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const replacements = [
+  ['@neondatabase/auth/react/ui/server', '@neondatabase/auth-ui/server'],
+  ['@neondatabase/auth/react/ui', '@neondatabase/auth-ui'],
+  ['@neondatabase/auth/ui/css', '@neondatabase/auth-ui/css'],
+  ['@neondatabase/auth/ui/tailwind', '@neondatabase/auth-ui/tailwind'],
+  ['@neondatabase/neon-js/auth/react/ui/server', '@neondatabase/auth-ui/server'],
+  ['@neondatabase/neon-js/auth/react/ui', '@neondatabase/auth-ui'],
+  ['@neondatabase/neon-js/ui/css', '@neondatabase/auth-ui/css'],
+  ['@neondatabase/neon-js/ui/tailwind', '@neondatabase/auth-ui/tailwind'],
+];
+
+const compatibilityReactSources = new Set([
+  '@neondatabase/auth/react',
+  '@neondatabase/neon-js/auth/react',
+]);
+
+const authUiExports = new Set([
+  'AcceptInvitationCard',
+  'AccountSettingsCards',
+  'AccountView',
+  'AccountsCard',
+  'AppleIcon',
+  'AuthCallback',
+  'AuthForm',
+  'AuthLoading',
+  'AuthUIContext',
+  'AuthUIProvider',
+  'AuthView',
+  'ChangeEmailCard',
+  'ChangePasswordCard',
+  'CreateOrganizationDialog',
+  'CreateTeamDialog',
+  'DeleteAccountCard',
+  'DeleteOrganizationCard',
+  'DiscordIcon',
+  'DropboxIcon',
+  'FacebookIcon',
+  'ForgotPasswordForm',
+  'GitHubIcon',
+  'GitLabIcon',
+  'GoogleIcon',
+  'HuggingFaceIcon',
+  'InputFieldSkeleton',
+  'KickIcon',
+  'LinearIcon',
+  'LinkedInIcon',
+  'MagicLinkForm',
+  'MicrosoftIcon',
+  'NeonAuthUIProvider',
+  'NotionIcon',
+  'OrganizationCellView',
+  'OrganizationInvitationsCard',
+  'OrganizationLogo',
+  'OrganizationLogoCard',
+  'OrganizationMembersCard',
+  'OrganizationNameCard',
+  'OrganizationSettingsCards',
+  'OrganizationSlugCard',
+  'OrganizationSwitcher',
+  'OrganizationView',
+  'OrganizationsCard',
+  'PasskeysCard',
+  'PasswordInput',
+  'ProvidersCard',
+  'RecoverAccountForm',
+  'RedditIcon',
+  'RedirectToSignIn',
+  'RedirectToSignUp',
+  'ResetPasswordForm',
+  'RobloxIcon',
+  'SecuritySettingsCards',
+  'SessionsCard',
+  'SettingsCard',
+  'SettingsCellSkeleton',
+  'SignInForm',
+  'SignOut',
+  'SignUpForm',
+  'SignedIn',
+  'SignedOut',
+  'SlackIcon',
+  'TeamCell',
+  'TeamsCard',
+  'SpotifyIcon',
+  'TikTokIcon',
+  'TwoFactorCard',
+  'TwoFactorForm',
+  'TwitchIcon',
+  'UpdateAvatarCard',
+  'UpdateFieldCard',
+  'UpdateNameCard',
+  'UpdateUsernameCard',
+  'UserAvatar',
+  'UserButton',
+  'UserInvitationsCard',
+  'UserView',
+  'VKIcon',
+  'XIcon',
+  'ZoomIcon',
+  'accountViewPaths',
+  'authLocalization',
+  'authViewPaths',
+  'getViewByPath',
+  'organizationViewPaths',
+  'socialProviders',
+  'useAuthData',
+  'useAuthenticate',
+  'useCurrentOrganization',
+  'useTheme',
+]);
+
+const supportedExtensions = new Set([
+  '.cjs',
+  '.css',
+  '.js',
+  '.jsx',
+  '.md',
+  '.mdx',
+  '.mjs',
+  '.scss',
+  '.ts',
+  '.tsx',
+]);
+
+const ignoredDirectories = new Set([
+  '.git',
+  '.next',
+  'build',
+  'coverage',
+  'dist',
+  'node_modules',
+]);
+
+function parseArgs(argv) {
+  const options = {
+    check: false,
+    write: false,
+    verifyExports: false,
+    dependencyVersion: undefined,
+    targets: [],
+  };
+
+  for (const arg of argv) {
+    switch (arg) {
+    case '--check': {
+      options.check = true;
+    
+    break;
+    }
+    case '--write': {
+      options.write = true;
+    
+    break;
+    }
+    case '--verify-exports': {
+      options.verifyExports = true;
+    
+    break;
+    }
+    default: { if (arg.startsWith('--dependency-version=')) {
+      options.dependencyVersion = arg.slice('--dependency-version='.length);
+    } else if (arg === '--help' || arg === '-h') {
+      printHelp();
+      process.exit(0);
+    } else {
+      options.targets.push(arg);
+    }
+    }
+    }
+  }
+
+  if (options.verifyExports) {
+    return options;
+  }
+
+  if (options.check === options.write) {
+    throw new Error('Choose exactly one mode: --check or --write.');
+  }
+
+  if (options.targets.length === 0) {
+    options.targets.push('.');
+  }
+
+  options.dependencyVersion ??= getDefaultAuthUiDependencyVersion();
+
+  return options;
+}
+
+function printHelp() {
+  console.log(`Usage: neon-auth-codemod (--check|--write|--verify-exports) [paths...]
+
+Migrates deprecated Neon Auth UI compatibility imports to @neondatabase/auth-ui.
+
+Options:
+  --check                         Report files that need migration and exit non-zero.
+  --write                         Rewrite files in place and update nearest package.json files.
+  --verify-exports                Check codemod UI symbol list against packages/auth/src/react/ui/index.ts.
+  --dependency-version=<version>  Version added to package.json dependencies. Defaults to this package's @neondatabase/auth-ui dependency.
+`);
+}
+
+function getDefaultAuthUiDependencyVersion() {
+  const currentFile = fileURLToPath(import.meta.url);
+  const packageJsonPath = resolve(dirname(currentFile), '..', 'package.json');
+
+  try {
+    const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+    const version = packageJson.dependencies?.['@neondatabase/auth-ui'];
+    if (typeof version === 'string' && !version.startsWith('workspace:')) {
+      return version;
+    }
+  } catch {
+    // Fall through to the stable default below.
+  }
+
+  return '^0.1.0';
+}
+
+function* walk(path) {
+  if (!existsSync(path)) {
+    return;
+  }
+
+  const stat = statSync(path);
+  if (stat.isFile()) {
+    if (supportedExtensions.has(extname(path))) {
+      yield path;
+    }
+    return;
+  }
+
+  if (!stat.isDirectory()) {
+    return;
+  }
+
+  for (const entry of readdirSync(path)) {
+    if (ignoredDirectories.has(entry)) {
+      continue;
+    }
+    yield* walk(join(path, entry));
+  }
+}
+
+function rewriteText(text) {
+  let next = rewriteCompatibilityReactImports(text);
+  for (const [from, to] of replacements) {
+    next = next.split(from).join(to);
+  }
+  return next;
+}
+
+function rewriteCompatibilityReactImports(text) {
+  return text.replaceAll(
+    /import\s+(type\s+)?\{([^}]*)\}\s+from\s+(['"])(@neondatabase\/(?:auth\/react|neon-js\/auth\/react))\3;?/g,
+    (match, typeKeyword = '', specifierBlock, quote, source) => {
+      if (!compatibilityReactSources.has(source)) {
+        return match;
+      }
+
+      const specifiers = specifierBlock
+        .split(',')
+        .map((specifier) => specifier.trim())
+        .filter(Boolean);
+      const uiSpecifiers = [];
+      const remainingSpecifiers = [];
+
+      for (const specifier of specifiers) {
+        const importedName = specifier.split(/\s+as\s+/i)[0]?.replace(/^type\s+/, '').trim();
+        if (authUiExports.has(importedName)) {
+          uiSpecifiers.push(specifier);
+        } else {
+          remainingSpecifiers.push(specifier);
+        }
+      }
+
+      if (uiSpecifiers.length === 0) {
+        return match;
+      }
+
+      const statements = [
+        `import ${typeKeyword}{ ${uiSpecifiers.join(', ')} } from '@neondatabase/auth-ui';`,
+      ];
+
+      if (remainingSpecifiers.length > 0) {
+        statements.push(
+          `import ${typeKeyword}{ ${remainingSpecifiers.join(', ')} } from ${quote}${source}${quote};`
+        );
+      }
+
+      return statements.join('\n');
+    }
+  );
+}
+
+export function extractAuthUiValueExports(sourcePath) {
+  const source = readFileSync(sourcePath, 'utf8');
+  const exports = new Set();
+
+  for (const match of source.matchAll(/export\s+\{([^}]*)\}\s+from\s+['"]@neondatabase\/auth-ui['"]/g)) {
+    for (const specifier of match[1].split(',')) {
+      const name = specifier.trim().split(/\s+as\s+/i)[0]?.trim();
+      if (name) {
+        exports.add(name);
+      }
+    }
+  }
+
+  return exports;
+}
+
+export function findMissingAuthUiExports(sourcePath = resolve('packages/auth/src/react/ui/index.ts')) {
+  const sourceExports = extractAuthUiValueExports(sourcePath);
+  return [...sourceExports].filter((name) => !authUiExports.has(name)).toSorted();
+}
+
+export function verifyAuthUiExports() {
+  const sourcePath = resolve('packages/auth/src/react/ui/index.ts');
+  const sourceExports = extractAuthUiValueExports(sourcePath);
+  const missing = findMissingAuthUiExports(sourcePath);
+
+  if (missing.length > 0) {
+    console.error(
+      `authUiExports is missing ${missing.length} value export(s) from ${sourcePath}:`
+    );
+    for (const name of missing) {
+      console.error(`- ${name}`);
+    }
+    process.exitCode = 1;
+    return;
+  }
+
+  console.log(`authUiExports covers ${sourceExports.size} value export(s) from ${sourcePath}.`);
+}
+
+function findPackageJson(start) {
+  let current = resolve(statSync(start).isDirectory() ? start : join(start, '..'));
+  const root = resolve('/');
+
+  while (current !== root) {
+    const candidate = join(current, 'package.json');
+    if (existsSync(candidate)) {
+      return candidate;
+    }
+    current = resolve(current, '..');
+  }
+
+  return null;
+}
+
+function updatePackageJson(packageJsonPath, dependencyVersion) {
+  const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf8'));
+  packageJson.dependencies ??= {};
+
+  if (packageJson.dependencies['@neondatabase/auth-ui']) {
+    return false;
+  }
+
+  packageJson.dependencies['@neondatabase/auth-ui'] = dependencyVersion;
+  writeFileSync(packageJsonPath, `${JSON.stringify(packageJson, null, 2)}\n`);
+  return true;
+}
+
+function main() {
+  const options = parseArgs(process.argv.slice(2));
+  if (options.verifyExports) {
+    verifyAuthUiExports();
+    return;
+  }
+
+  const changedFiles = [];
+  const packageJsons = new Set();
+
+  for (const target of options.targets.map((target) => resolve(target))) {
+    for (const file of walk(target)) {
+      const original = readFileSync(file, 'utf8');
+      const next = rewriteText(original);
+      if (next === original) {
+        continue;
+      }
+
+      changedFiles.push(file);
+      const packageJsonPath = findPackageJson(file);
+      if (packageJsonPath) {
+        packageJsons.add(packageJsonPath);
+      }
+
+      if (options.write) {
+        writeFileSync(file, next);
+      }
+    }
+  }
+
+  const changedPackageJsons = [];
+  if (options.write) {
+    for (const packageJsonPath of packageJsons) {
+      if (updatePackageJson(packageJsonPath, options.dependencyVersion)) {
+        changedPackageJsons.push(packageJsonPath);
+      }
+    }
+  }
+
+  if (changedFiles.length === 0) {
+    console.log('No deprecated Neon Auth UI imports found.');
+    return;
+  }
+
+  const mode = options.write ? 'Updated' : 'Would update';
+  console.log(`${mode} ${changedFiles.length} file(s):`);
+  for (const file of changedFiles) {
+    console.log(`- ${file}`);
+  }
+
+  if (changedPackageJsons.length > 0) {
+    console.log(`\nAdded @neondatabase/auth-ui to ${changedPackageJsons.length} package.json file(s):`);
+    for (const packageJsonPath of changedPackageJsons) {
+      console.log(`- ${packageJsonPath}`);
+    }
+    console.log('\nRun your package manager install command to update the lockfile.');
+  }
+
+  if (options.check) {
+    process.exitCode = 1;
+  }
+}
+
+if (import.meta.url === `file://${process.argv[1]}`) {
+  try {
+    main();
+  } catch (error) {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exitCode = 1;
+  }
+}

package/dist/{adapter-core-D00qcqMo.mjs → adapter-core-BFMM3lwe.mjs}

@@ -1,6 +1,6 @@
-import { a as NEON_AUTH_POPUP_PARAM_NAME, c as SESSION_CACHE_TTL_MS, i as NEON_AUTH_POPUP_CALLBACK_ROUTE, o as NEON_AUTH_SESSION_VERIFIER_PARAM_NAME, r as NEON_AUTH_POPUP_CALLBACK_PARAM_NAME, s as OAUTH_POPUP_MESSAGE_TYPE, t as CLOCK_SKEW_BUFFER_MS } from "./constants-Cupc_bln.mjs";
+import { d as NEON_AUTH_POPUP_CALLBACK_PARAM_NAME, f as NEON_AUTH_POPUP_CALLBACK_ROUTE, g as SESSION_CACHE_TTL_MS, h as OAUTH_POPUP_MESSAGE_TYPE, m as NEON_AUTH_SESSION_VERIFIER_PARAM_NAME, p as NEON_AUTH_POPUP_PARAM_NAME, r as normalizeBetterAuthError, u as CLOCK_SKEW_BUFFER_MS } from "./better-auth-helpers-Bkezghej.mjs";
 import { getGlobalBroadcastChannel } from "better-auth/client";
-import { adminClient, emailOTPClient, jwtClient, organizationClient } from "better-auth/client/plugins";
+import { adminClient, emailOTPClient, jwtClient, magicLinkClient, organizationClient } from "better-auth/client/plugins";
 import z from "zod";
 
 //#region src/core/in-flight-request-manager.ts
@@ -490,6 +490,9 @@ const BETTER_AUTH_METHODS_HOOKS = {
 	},
 	getSession: {
 		beforeFetch: () => {
+			if (isBrowser()) {
+				if (new URLSearchParams(globalThis.window.location.search).has(NEON_AUTH_SESSION_VERIFIER_PARAM_NAME)) return null;
+			}
 			const cachedData = BETTER_AUTH_METHODS_CACHE.getCachedSession();
 			if (!cachedData) return null;
 			return Response.json(cachedData, { status: 200 });
@@ -629,7 +632,7 @@ function initBroadcastChannel() {
 //#endregion
 //#region package.json
 var name = "@neondatabase/auth";
-var version = "0.3.0-beta";
+var version = "0.4.1-beta";
 
 //#endregion
 //#region ../internal/dist/index.mjs
@@ -724,6 +727,7 @@ const supportedBetterAuthClientPlugins = [
 	adminClient(),
 	organizationClient(),
 	emailOTPClient(),
+	magicLinkClient(),
 	anonymousTokenClient()
 ];
 var NeonAuthAdapterCore = class {
@@ -757,10 +761,13 @@ var NeonAuthAdapterCore = class {
 						});
 						if (!response$1.ok) {
 							const body = await response$1.clone().json().catch(() => ({}));
-							const err = new Error(body.message || `HTTP ${response$1.status} ${response$1.statusText}`);
-							err.status = response$1.status;
-							err.statusText = response$1.statusText;
-							throw err;
+							throw normalizeBetterAuthError({
+								status: response$1.status,
+								statusText: response$1.statusText,
+								message: body.message || `HTTP ${response$1.status} ${response$1.statusText}`,
+								code: body.code,
+								body
+							});
 						}
 						return response$1;
 					}
@@ -776,10 +783,13 @@ var NeonAuthAdapterCore = class {
 					}));
 					if (!response.ok) {
 						const errorBody = await response.clone().json().catch(() => ({}));
-						const err = new Error(errorBody.message || `HTTP ${response.status} ${response.statusText}`);
-						err.status = response.status;
-						err.statusText = response.statusText;
-						throw err;
+						throw normalizeBetterAuthError({
+							status: response.status,
+							statusText: response.statusText,
+							message: errorBody.message || `HTTP ${response.status} ${response.statusText}`,
+							code: errorBody.code,
+							body: errorBody
+						});
 					}
 					return response.clone();
 				},