@payez/next-mvp 3.9.0 → 3.9.1

package/dist/client/better-auth-client.d.ts

@@ -4,11 +4,8 @@
  * Drop-in replacement for next-auth/react hooks and functions.
  * Import from '@payez/next-mvp/client/better-auth-client'.
  *
- * Migration map:
- *   useSession()        → authClient.useSession()
- *   signIn('google')    → authClient.signIn.social({ provider: 'google' })
- *   signIn('credentials', {...}) → authClient.signIn.email({...})
- *   signOut()           → authClient.signOut()
+ * Includes useSessionCompat() — returns NextAuth-shaped { data, status }
+ * so existing components don't need destructure pattern changes.
  */
 export declare const authClient: {
     signIn: {
@@ -959,3 +956,65 @@ export declare const useSession: () => {
     code?: string | undefined;
     message?: string | undefined;
 }, FetchOptions["throw"] extends true ? true : false>>;
+/**
+ * NextAuth-compatible useSession wrapper.
+ *
+ * Maps Better Auth's { data, error, isPending } to NextAuth's { data, status, update }.
+ * Drop-in replacement — no destructure changes needed in consuming components.
+ */
+export declare function useSessionCompat(): {
+    data: {
+        user: import("better-auth/react").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            email: string;
+            emailVerified: boolean;
+            name: string;
+            image?: string | null | undefined;
+        }>;
+        expires: string;
+        session: import("better-auth/react").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            userId: string;
+            expiresAt: Date;
+            token: string;
+            ipAddress?: string | null | undefined;
+            userAgent?: string | null | undefined;
+        }>;
+    } | null;
+    status: "loading" | "authenticated" | "unauthenticated";
+    update: () => Promise<{
+        user: import("better-auth/react").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            email: string;
+            emailVerified: boolean;
+            name: string;
+            image?: string | null | undefined;
+        }>;
+        expires: string;
+        session: import("better-auth/react").StripEmptyObjects<{
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            userId: string;
+            expiresAt: Date;
+            token: string;
+            ipAddress?: string | null | undefined;
+            userAgent?: string | null | undefined;
+        }>;
+    } | null>;
+};
+/**
+ * NextAuth-compatible signOut wrapper.
+ *
+ * Maps NextAuth signOut({ redirect, callbackUrl }) to Better Auth.
+ */
+export declare function signOutCompat(options?: {
+    redirect?: boolean;
+    callbackUrl?: string;
+}): Promise<void>;

package/dist/client/better-auth-client.js

@@ -5,17 +5,64 @@
  * Drop-in replacement for next-auth/react hooks and functions.
  * Import from '@payez/next-mvp/client/better-auth-client'.
  *
- * Migration map:
- *   useSession()        → authClient.useSession()
- *   signIn('google')    → authClient.signIn.social({ provider: 'google' })
- *   signIn('credentials', {...}) → authClient.signIn.email({...})
- *   signOut()           → authClient.signOut()
+ * Includes useSessionCompat() — returns NextAuth-shaped { data, status }
+ * so existing components don't need destructure pattern changes.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.signOut = exports.signIn = exports.useSession = exports.authClient = void 0;
+exports.useSessionCompat = useSessionCompat;
+exports.signOutCompat = signOutCompat;
 const react_1 = require("better-auth/react");
+const react_2 = require("react");
 exports.authClient = (0, react_1.createAuthClient)({
-// baseURL is derived from BETTER_AUTH_URL or window.location.origin
+// baseURL derived from BETTER_AUTH_URL or window.location.origin
 });
-// Convenience exports matching NextAuth patterns
+// Convenience exports
 exports.useSession = exports.authClient.useSession, exports.signIn = exports.authClient.signIn, exports.signOut = exports.authClient.signOut;
+/**
+ * NextAuth-compatible useSession wrapper.
+ *
+ * Maps Better Auth's { data, error, isPending } to NextAuth's { data, status, update }.
+ * Drop-in replacement — no destructure changes needed in consuming components.
+ */
+function useSessionCompat() {
+    const baSession = exports.authClient.useSession();
+    const status = (0, react_2.useMemo)(() => {
+        if (baSession.isPending)
+            return 'loading';
+        if (baSession.data)
+            return 'authenticated';
+        return 'unauthenticated';
+    }, [baSession.isPending, baSession.data]);
+    // Map Better Auth session shape to NextAuth session shape
+    const data = (0, react_2.useMemo)(() => {
+        if (!baSession.data)
+            return null;
+        return {
+            ...baSession.data,
+            user: baSession.data.user,
+            expires: '', // Better Auth handles expiry differently
+        };
+    }, [baSession.data]);
+    return {
+        data,
+        status,
+        update: async () => {
+            // Better Auth doesn't have a direct "refresh session" call.
+            // Force refetch by invalidating the query.
+            // TODO: Wire to proper session refresh when available.
+            return data;
+        },
+    };
+}
+/**
+ * NextAuth-compatible signOut wrapper.
+ *
+ * Maps NextAuth signOut({ redirect, callbackUrl }) to Better Auth.
+ */
+async function signOutCompat(options) {
+    await exports.authClient.signOut();
+    if (options?.redirect !== false && options?.callbackUrl) {
+        window.location.href = options.callbackUrl;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@payez/next-mvp",
-  "version": "3.9.0",
+  "version": "3.9.1",
   "sideEffects": false,
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/client/better-auth-client.ts

@@ -4,18 +4,65 @@
  * Drop-in replacement for next-auth/react hooks and functions.
  * Import from '@payez/next-mvp/client/better-auth-client'.
  *
- * Migration map:
- *   useSession()        → authClient.useSession()
- *   signIn('google')    → authClient.signIn.social({ provider: 'google' })
- *   signIn('credentials', {...}) → authClient.signIn.email({...})
- *   signOut()           → authClient.signOut()
+ * Includes useSessionCompat() — returns NextAuth-shaped { data, status }
+ * so existing components don't need destructure pattern changes.
  */
 
 import { createAuthClient } from 'better-auth/react';
+import { useMemo } from 'react';
 
 export const authClient = createAuthClient({
-  // baseURL is derived from BETTER_AUTH_URL or window.location.origin
+  // baseURL derived from BETTER_AUTH_URL or window.location.origin
 });
 
-// Convenience exports matching NextAuth patterns
+// Convenience exports
 export const { useSession, signIn, signOut } = authClient;
+
+/**
+ * NextAuth-compatible useSession wrapper.
+ *
+ * Maps Better Auth's { data, error, isPending } to NextAuth's { data, status, update }.
+ * Drop-in replacement — no destructure changes needed in consuming components.
+ */
+export function useSessionCompat() {
+  const baSession = authClient.useSession();
+
+  const status = useMemo(() => {
+    if (baSession.isPending) return 'loading' as const;
+    if (baSession.data) return 'authenticated' as const;
+    return 'unauthenticated' as const;
+  }, [baSession.isPending, baSession.data]);
+
+  // Map Better Auth session shape to NextAuth session shape
+  const data = useMemo(() => {
+    if (!baSession.data) return null;
+    return {
+      ...baSession.data,
+      user: baSession.data.user,
+      expires: '', // Better Auth handles expiry differently
+    };
+  }, [baSession.data]);
+
+  return {
+    data,
+    status,
+    update: async () => {
+      // Better Auth doesn't have a direct "refresh session" call.
+      // Force refetch by invalidating the query.
+      // TODO: Wire to proper session refresh when available.
+      return data;
+    },
+  };
+}
+
+/**
+ * NextAuth-compatible signOut wrapper.
+ *
+ * Maps NextAuth signOut({ redirect, callbackUrl }) to Better Auth.
+ */
+export async function signOutCompat(options?: { redirect?: boolean; callbackUrl?: string }) {
+  await authClient.signOut();
+  if (options?.redirect !== false && options?.callbackUrl) {
+    window.location.href = options.callbackUrl;
+  }
+}