@umituz/react-native-auth 3.3.0 → 3.4.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-auth",
-  "version": "3.3.0",
+  "version": "3.4.0",
   "description": "Authentication service for React Native apps - Secure, type-safe, and production-ready. Provider-agnostic design with dependency injection, configurable validation, and comprehensive error handling.",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/infrastructure/services/initializeAuth.ts

@@ -6,6 +6,7 @@
  * - AuthService (email/password auth)
  * - Auth Listener (state management)
  * - User Document Service (Firestore)
+ * - Anonymous-to-authenticated conversion detection
  */
 
 import type { Auth, User } from "firebase/auth";
@@ -32,7 +33,22 @@ export interface InitializeAuthOptions {
   /** Enable auto anonymous sign-in (default: true) */
   autoAnonymousSignIn?: boolean;
 
-  /** Callback when auth state changes */
+  /**
+   * Callback when user converts from anonymous to authenticated
+   * Use this to migrate user data (e.g., call Cloud Function)
+   *
+   * @param anonymousUserId - The previous anonymous user ID
+   * @param authenticatedUserId - The new authenticated user ID
+   */
+  onUserConverted?: (
+    anonymousUserId: string,
+    authenticatedUserId: string
+  ) => void | Promise<void>;
+
+  /**
+   * Callback when auth state changes (after user document is ensured)
+   * Called for every auth state change including initial load
+   */
   onAuthStateChange?: (user: User | null) => void | Promise<void>;
 
   /** Auth configuration (password rules, etc.) */
@@ -41,20 +57,23 @@ export interface InitializeAuthOptions {
 
 let isInitialized = false;
 
+// Track previous user for conversion detection
+let previousUserId: string | null = null;
+let wasAnonymous = false;
+
 /**
  * Initialize all auth services with a single call
  *
  * @example
  * ```typescript
- * import { initializeAuth, ensureUserDocument } from '@umituz/react-native-auth';
+ * import { initializeAuth } from '@umituz/react-native-auth';
+ * import { migrateUserData } from '@domains/migration';
  *
  * await initializeAuth({
  *   userCollection: 'users',
  *   autoAnonymousSignIn: true,
- *   onAuthStateChange: async (user) => {
- *     if (user) {
- *       await ensureUserDocument(user);
- *     }
+ *   onUserConverted: async (anonymousId, authId) => {
+ *     await migrateUserData(anonymousId, authId);
  *   },
  * });
  * ```
@@ -72,6 +91,7 @@ export async function initializeAuth(
     extraFields,
     collectExtras,
     autoAnonymousSignIn = true,
+    onUserConverted,
     onAuthStateChange,
     authConfig,
   } = options;
@@ -103,15 +123,41 @@ export async function initializeAuth(
   initializeAuthListener({
     autoAnonymousSignIn,
     onAuthStateChange: async (user) => {
-      // Auto-create/update user document
-      if (user) {
-        await ensureUserDocument(user);
+      if (!user) {
+        // User signed out
+        previousUserId = null;
+        wasAnonymous = false;
+        onAuthStateChange?.(null);
+        return;
       }
 
-      // Call app's custom callback
-      if (onAuthStateChange) {
-        await onAuthStateChange(user);
+      const currentUserId = user.uid;
+      const isCurrentlyAnonymous = user.isAnonymous ?? false;
+
+      // Detect anonymous-to-authenticated conversion
+      if (
+        previousUserId &&
+        previousUserId !== currentUserId &&
+        wasAnonymous &&
+        !isCurrentlyAnonymous &&
+        onUserConverted
+      ) {
+        try {
+          await onUserConverted(previousUserId, currentUserId);
+        } catch {
+          // Migration failed but don't block user flow
+        }
       }
+
+      // Create/update user document in Firestore
+      await ensureUserDocument(user);
+
+      // Update tracking state
+      previousUserId = currentUserId;
+      wasAnonymous = isCurrentlyAnonymous;
+
+      // Call app's custom callback
+      onAuthStateChange?.(user);
     },
   });
 
@@ -131,4 +177,6 @@ export function isAuthInitialized(): boolean {
  */
 export function resetAuthInitialization(): void {
   isInitialized = false;
+  previousUserId = null;
+  wasAnonymous = false;
 }