svelte-firekit 0.1.9 → 0.2.0

package/dist/services/user.svelte.js

@@ -1,287 +1,143 @@
-/**
- * @fileoverview FirekitUser Store - Reactive user state management using Svelte 5 runes
- * @module FirekitUserStore
- * @version 1.0.0
- */
 import { onAuthStateChanged, updateProfile, updateEmail, updatePassword, reload, sendEmailVerification, getIdToken } from 'firebase/auth';
 import { doc, setDoc, getDoc, serverTimestamp } from 'firebase/firestore';
 import { firebaseService } from '../firebase.js';
 import { FirekitAuthError, AuthErrorCode } from '../types/auth.js';
 import { mapFirebaseUserToProfile, updateUserInFirestore, createAuthError, validateCurrentUser } from '../utils/index.js';
 /**
- * Reactive user store using Svelte 5 runes for state management.
- * Provides real-time authentication state and user profile management.
+ * Reactive user store — the single source of truth for auth state.
+ * Uses Svelte 5 `$state` / `$derived` runes so all getters are reactive
+ * and can be read directly in components without subscriptions.
  *
- * @class FirekitUserStore
  * @example
- * ```typescript
  * import { firekitUser } from 'svelte-firekit';
  *
- * // Access reactive state
- * $: if (firekitUser.isAuthenticated) {
- *   console.log("User:", firekitUser.user);
- * }
- *
- * // Update profile
- * await firekitUser.updateDisplayName("John Doe");
- *
- * // Get extended user data
- * const userData = await firekitUser.getExtendedUserData();
- * ```
+ * // In a .svelte file — reactive, no subscription needed
+ * {#if firekitUser.isAuthenticated}
+ *   <p>Hello {firekitUser.displayName}</p>
+ * {/if}
  */
 class FirekitUserStore {
     static instance;
     auth = null;
     firestore = null;
-    _servicesInitialized = false;
-    // ========================================
-    // REACTIVE STATE (Svelte 5 Runes)
-    // ========================================
-    /** Current user profile state */
+    // ── Reactive state ───────────────────────────────────────────────────────────
     _user = $state(null);
-    /** Loading state indicator */
     _loading = $state(true);
-    /** Authentication initialization state */
     _initialized = $state(false);
-    /** Current error state */
     _error = $state(null);
-    // ========================================
-    // DERIVED STATE
-    // ========================================
-    /** Derived: Whether user is authenticated (not anonymous) */
+    // ── Derived ──────────────────────────────────────────────────────────────────
     _isAuthenticated = $derived(this._user !== null && !this._user.isAnonymous);
-    /** Derived: Whether user is anonymous */
     _isAnonymous = $derived(this._user?.isAnonymous ?? false);
-    /** Derived: Whether user's email is verified */
     _isEmailVerified = $derived(this._user?.emailVerified ?? false);
-    /** Derived: User's primary email address */
-    _userEmail = $derived(this._user?.email ?? null);
-    /** Derived: User's display name */
-    _userDisplayName = $derived(this._user?.displayName ?? null);
-    /** Derived: User's photo URL */
-    _userPhotoURL = $derived(this._user?.photoURL ?? null);
-    /** Derived: User's unique ID */
-    _userId = $derived(this._user?.uid ?? null);
-    /** Derived: User's phone number */
-    _userPhoneNumber = $derived(this._user?.phoneNumber ?? null);
+    _email = $derived(this._user?.email ?? null);
+    _displayName = $derived(this._user?.displayName ?? null);
+    _photoURL = $derived(this._user?.photoURL ?? null);
+    _uid = $derived(this._user?.uid ?? null);
+    _phoneNumber = $derived(this._user?.phoneNumber ?? null);
     constructor() {
         if (typeof window !== 'undefined') {
-            // Initialize Firebase services immediately like the old working code
-            this.initializeServices();
+            this.bootstrap();
         }
     }
-    /**
-     * Gets singleton instance of FirekitUserStore
-     * @returns {FirekitUserStore} The FirekitUserStore instance
-     */
     static getInstance() {
         if (!FirekitUserStore.instance) {
             FirekitUserStore.instance = new FirekitUserStore();
         }
         return FirekitUserStore.instance;
     }
-    /**
-     * Initializes Firebase services and auth state listener
-     * @private
-     */
-    initializeServices() {
-        if (this._servicesInitialized)
-            return;
+    bootstrap() {
         try {
             this.auth = firebaseService.getAuthInstance();
-            this.firestore = firebaseService.getDbInstance();
-            this._servicesInitialized = true;
-            this.initializeAuthStateListener();
+            try {
+                this.firestore = firebaseService.getDbInstance();
+            }
+            catch {
+                this.firestore = null;
+            }
+            this.listenToAuthState();
         }
-        catch (error) {
-            console.error('Failed to initialize Firebase services:', error);
-            this._error = error instanceof Error ? error : new Error(String(error));
+        catch (err) {
+            this._error = err instanceof Error ? err : new Error(String(err));
             this._loading = false;
             this._initialized = true;
         }
     }
-    /**
-     * Initializes the authentication state listener
-     * @private
-     */
-    initializeAuthStateListener() {
-        if (!this.auth) {
-            console.error('Auth instance not available');
+    listenToAuthState() {
+        if (!this.auth)
             return;
-        }
         onAuthStateChanged(this.auth, (firebaseUser) => {
-            this._user = firebaseUser ? this.mapFirebaseUserToProfile(firebaseUser) : null;
+            this._user = firebaseUser ? mapFirebaseUserToProfile(firebaseUser) : null;
             this._loading = false;
             this._initialized = true;
             this._error = null;
-        }, (error) => {
-            console.error('Auth state change error:', error);
-            this._error = error;
+        }, (err) => {
+            this._error = err;
             this._loading = false;
             this._initialized = true;
         });
     }
-    /**
-     * Maps Firebase User to UserProfile interface
-     * @private
-     */
-    mapFirebaseUserToProfile(user) {
-        return mapFirebaseUserToProfile(user);
-    }
-    /**
-     * Updates user data in Firestore
-     * @private
-     */
-    async updateUserInFirestore(user) {
-        if (!this.firestore) {
-            throw new Error('Firestore instance not available');
-        }
+    async syncToFirestore(user) {
+        if (!this.firestore)
+            return;
         await updateUserInFirestore(this.firestore, user);
     }
-    // ========================================
-    // PUBLIC GETTERS (Reactive State)
-    // ========================================
-    /** Current user profile */
-    get user() {
-        return this._user;
-    }
-    /** Current loading state */
-    get loading() {
-        return this._loading;
-    }
-    /** Whether auth has been initialized */
-    get initialized() {
-        return this._initialized;
-    }
-    /** Current error state */
-    get error() {
-        return this._error;
-    }
-    /** Whether user is authenticated (not anonymous) */
-    get isAuthenticated() {
-        return this._isAuthenticated;
-    }
-    /** Whether user is anonymous */
-    get isAnonymous() {
-        return this._isAnonymous;
-    }
-    /** Whether user's email is verified */
-    get isEmailVerified() {
-        return this._isEmailVerified;
-    }
-    /** User's email address */
-    get email() {
-        return this._userEmail;
-    }
-    /** User's display name */
-    get displayName() {
-        return this._userDisplayName;
-    }
-    /** User's photo URL */
-    get photoURL() {
-        return this._userPhotoURL;
-    }
-    /** User's unique ID */
-    get uid() {
-        return this._userId;
-    }
-    /** User's phone number */
-    get phoneNumber() {
-        return this._userPhoneNumber;
-    }
-    // ========================================
-    // PROFILE UPDATE METHODS
-    // ========================================
-    /**
-     * Updates user's display name
-     * @param {string} displayName New display name
-     * @returns {Promise<void>} Promise that resolves when update completes
-     * @throws {FirekitAuthError} If update fails
-     *
-     * @example
-     * ```typescript
-     * await firekitUser.updateDisplayName("John Doe");
-     * ```
-     */
+    currentFirebaseUser() {
+        return validateCurrentUser(this.auth);
+    }
+    // ── Public getters (reactive) ────────────────────────────────────────────────
+    get user() { return this._user; }
+    get loading() { return this._loading; }
+    get initialized() { return this._initialized; }
+    get error() { return this._error; }
+    get isAuthenticated() { return this._isAuthenticated; }
+    get isAnonymous() { return this._isAnonymous; }
+    get isEmailVerified() { return this._isEmailVerified; }
+    get email() { return this._email; }
+    get displayName() { return this._displayName; }
+    get photoURL() { return this._photoURL; }
+    get uid() { return this._uid; }
+    get phoneNumber() { return this._phoneNumber; }
+    // ── Profile updates ──────────────────────────────────────────────────────────
     async updateDisplayName(displayName) {
-        if (!this.auth) {
-            throw new Error('Auth instance not available');
-        }
-        const currentUser = validateCurrentUser(this.auth);
+        const user = this.currentFirebaseUser();
         try {
             this._loading = true;
-            await updateProfile(currentUser, { displayName });
-            await this.updateUserInFirestore(currentUser);
-            // Update local state
-            if (this._user) {
+            await updateProfile(user, { displayName });
+            await this.syncToFirestore(user);
+            if (this._user)
                 this._user = { ...this._user, displayName };
-            }
         }
-        catch (error) {
-            this._error = error;
-            throw createAuthError(error, 'update display name');
+        catch (err) {
+            this._error = err instanceof Error ? err : new Error(String(err));
+            throw createAuthError(err, 'update display name');
         }
         finally {
             this._loading = false;
         }
     }
-    /**
-     * Updates user's photo URL
-     * @param {string} photoURL New photo URL
-     * @returns {Promise<void>} Promise that resolves when update completes
-     * @throws {FirekitAuthError} If update fails
-     *
-     * @example
-     * ```typescript
-     * await firekitUser.updatePhotoURL("https://example.com/photo.jpg");
-     * ```
-     */
     async updatePhotoURL(photoURL) {
-        if (!this.auth) {
-            throw new Error('Auth instance not available');
-        }
-        const currentUser = validateCurrentUser(this.auth);
+        const user = this.currentFirebaseUser();
         try {
             this._loading = true;
-            await updateProfile(currentUser, { photoURL });
-            await this.updateUserInFirestore(currentUser);
-            // Update local state
-            if (this._user) {
+            await updateProfile(user, { photoURL });
+            await this.syncToFirestore(user);
+            if (this._user)
                 this._user = { ...this._user, photoURL };
-            }
         }
-        catch (error) {
-            this._error = error;
-            throw createAuthError(error, 'update photo URL');
+        catch (err) {
+            this._error = err instanceof Error ? err : new Error(String(err));
+            throw createAuthError(err, 'update photo URL');
         }
         finally {
             this._loading = false;
         }
     }
-    /**
-     * Updates user's profile data
-     * @param {UserProfileUpdateData} profileData Profile data to update
-     * @returns {Promise<void>} Promise that resolves when update completes
-     * @throws {FirekitAuthError} If update fails
-     *
-     * @example
-     * ```typescript
-     * await firekitUser.updateProfile({
-     *   displayName: "John Smith",
-     *   photoURL: "https://example.com/new-photo.jpg"
-     * });
-     * ```
-     */
     async updateProfile(profileData) {
-        if (!this.auth) {
-            throw new Error('Auth instance not available');
-        }
-        const currentUser = validateCurrentUser(this.auth);
+        const user = this.currentFirebaseUser();
         try {
             this._loading = true;
-            await updateProfile(currentUser, profileData);
-            await this.updateUserInFirestore(currentUser);
-            // Update local state
+            await updateProfile(user, profileData);
+            await this.syncToFirestore(user);
             if (this._user) {
                 this._user = {
                     ...this._user,
@@ -290,299 +146,133 @@ class FirekitUserStore {
                 };
             }
         }
-        catch (error) {
-            this._error = error;
-            throw createAuthError(error, 'update profile');
+        catch (err) {
+            this._error = err instanceof Error ? err : new Error(String(err));
+            throw createAuthError(err, 'update profile');
         }
         finally {
             this._loading = false;
         }
     }
-    /**
-     * Updates user's email address
-     * @param {string} newEmail New email address
-     * @returns {Promise<void>} Promise that resolves when update completes
-     * @throws {FirekitAuthError} If update fails
-     *
-     * @example
-     * ```typescript
-     * await firekitUser.updateEmail("newemail@example.com");
-     * ```
-     */
     async updateEmail(newEmail) {
-        if (!this.auth) {
-            throw new Error('Auth instance not available');
-        }
-        const currentUser = validateCurrentUser(this.auth);
+        const user = this.currentFirebaseUser();
         try {
             this._loading = true;
-            await updateEmail(currentUser, newEmail);
-            await this.updateUserInFirestore(currentUser);
-            // Update local state
-            if (this._user) {
+            await updateEmail(user, newEmail);
+            await this.syncToFirestore(user);
+            if (this._user)
                 this._user = { ...this._user, email: newEmail, emailVerified: false };
-            }
         }
-        catch (error) {
-            this._error = error;
-            throw createAuthError(error, 'update email');
+        catch (err) {
+            this._error = err instanceof Error ? err : new Error(String(err));
+            throw createAuthError(err, 'update email');
         }
         finally {
             this._loading = false;
         }
     }
-    /**
-     * Updates user's password
-     * @param {string} newPassword New password
-     * @returns {Promise<void>} Promise that resolves when update completes
-     * @throws {FirekitAuthError} If update fails
-     *
-     * @example
-     * ```typescript
-     * await firekitUser.updatePassword("newSecurePassword123");
-     * ```
-     */
     async updatePassword(newPassword) {
-        if (!this.auth) {
-            throw new Error('Auth instance not available');
-        }
-        const currentUser = validateCurrentUser(this.auth);
+        const user = this.currentFirebaseUser();
         try {
             this._loading = true;
-            await updatePassword(currentUser, newPassword);
+            await updatePassword(user, newPassword);
         }
-        catch (error) {
-            this._error = error;
-            throw createAuthError(error, 'update password');
+        catch (err) {
+            this._error = err instanceof Error ? err : new Error(String(err));
+            throw createAuthError(err, 'update password');
         }
         finally {
             this._loading = false;
         }
     }
-    // ========================================
-    // EMAIL VERIFICATION METHODS
-    // ========================================
-    /**
-     * Sends email verification to current user
-     * @returns {Promise<void>} Promise that resolves when verification email is sent
-     * @throws {FirekitAuthError} If sending fails
-     *
-     * @example
-     * ```typescript
-     * await firekitUser.sendEmailVerification();
-     * ```
-     */
+    // ── Email verification ───────────────────────────────────────────────────────
     async sendEmailVerification() {
-        if (!this.auth) {
-            throw new Error('Auth instance not available');
-        }
-        const currentUser = validateCurrentUser(this.auth);
+        const user = this.currentFirebaseUser();
         try {
-            await sendEmailVerification(currentUser);
+            await sendEmailVerification(user);
         }
-        catch (error) {
-            this._error = error;
-            throw createAuthError(error, 'send email verification');
+        catch (err) {
+            this._error = err instanceof Error ? err : new Error(String(err));
+            throw createAuthError(err, 'send email verification');
         }
     }
-    /**
-     * Reloads user to get updated email verification status
-     * @returns {Promise<void>} Promise that resolves when user is reloaded
-     * @throws {FirekitAuthError} If reload fails
-     *
-     * @example
-     * ```typescript
-     * await firekitUser.reloadUser();
-     * ```
-     */
     async reloadUser() {
-        if (!this.auth) {
-            throw new Error('Auth instance not available');
-        }
-        const currentUser = validateCurrentUser(this.auth);
+        const user = this.currentFirebaseUser();
         try {
             this._loading = true;
-            await reload(currentUser);
-            await this.updateUserInFirestore(currentUser);
-            // Update local state with reloaded data
-            this._user = this.mapFirebaseUserToProfile(currentUser);
+            await reload(user);
+            await this.syncToFirestore(user);
+            this._user = mapFirebaseUserToProfile(user);
         }
-        catch (error) {
-            this._error = error;
-            throw createAuthError(error, 'reload user');
+        catch (err) {
+            this._error = err instanceof Error ? err : new Error(String(err));
+            throw createAuthError(err, 'reload user');
         }
         finally {
             this._loading = false;
         }
     }
-    // ========================================
-    // TOKEN METHODS
-    // ========================================
-    /**
-     * Gets the current user's ID token
-     * @param {boolean} [forceRefresh=false] Whether to force token refresh
-     * @returns {Promise<string>} Promise resolving to ID token
-     * @throws {FirekitAuthError} If getting token fails
-     *
-     * @example
-     * ```typescript
-     * const token = await firekitUser.getIdToken();
-     * ```
-     */
+    // ── Token ────────────────────────────────────────────────────────────────────
     async getIdToken(forceRefresh = false) {
-        if (!this.auth) {
-            throw new Error('Auth instance not available');
-        }
-        const currentUser = validateCurrentUser(this.auth);
+        const user = this.currentFirebaseUser();
         try {
-            return await getIdToken(currentUser, forceRefresh);
+            return await getIdToken(user, forceRefresh);
         }
-        catch (error) {
-            this._error = error;
-            throw createAuthError(error, 'get ID token');
+        catch (err) {
+            this._error = err instanceof Error ? err : new Error(String(err));
+            throw createAuthError(err, 'get ID token');
         }
     }
-    // ========================================
-    // FIRESTORE EXTENDED DATA METHODS
-    // ========================================
-    /**
-     * Gets extended user data from Firestore
-     * @returns {Promise<ExtendedUserData | null>} Promise resolving to extended user data
-     *
-     * @example
-     * ```typescript
-     * const userData = await firekitUser.getExtendedUserData();
-     * console.log(userData?.preferences);
-     * ```
-     */
-    async getExtendedUserData() {
-        if (!this._user?.uid || !this.firestore) {
+    // ── Extended Firestore data ──────────────────────────────────────────────────
+    async getExtendedData() {
+        if (!this._user?.uid || !this.firestore)
             return null;
-        }
         try {
-            const userRef = doc(this.firestore, 'users', this._user.uid);
-            const userDoc = await getDoc(userRef);
-            if (userDoc.exists()) {
-                return userDoc.data();
-            }
-            return null;
+            const snap = await getDoc(doc(this.firestore, 'users', this._user.uid));
+            return snap.exists() ? snap.data() : null;
         }
-        catch (error) {
-            console.error('Failed to get extended user data:', error);
-            this._error = error;
+        catch {
             return null;
         }
     }
-    /**
-     * Updates extended user data in Firestore
-     * @param {Partial<ExtendedUserData>} data Data to update
-     * @returns {Promise<void>} Promise that resolves when update completes
-     *
-     * @example
-     * ```typescript
-     * await firekitUser.updateExtendedUserData({
-     *   preferences: { theme: 'dark', language: 'en' },
-     *   settings: { notifications: true }
-     * });
-     * ```
-     */
-    async updateExtendedUserData(data) {
+    async updateExtendedData(data) {
         if (!this._user?.uid) {
             throw new FirekitAuthError(AuthErrorCode.USER_NOT_FOUND, 'No authenticated user found.');
         }
         if (!this.firestore) {
-            throw new Error('Firestore instance not available');
+            throw new Error('Firestore instance not available.');
         }
         try {
-            const userRef = doc(this.firestore, 'users', this._user.uid);
-            await setDoc(userRef, {
-                ...data,
-                updatedAt: serverTimestamp()
-            }, { merge: true });
+            await setDoc(doc(this.firestore, 'users', this._user.uid), { ...data, updatedAt: serverTimestamp() }, { merge: true });
         }
-        catch (error) {
-            this._error = error;
-            throw createAuthError(error, 'update user data');
+        catch (err) {
+            this._error = err instanceof Error ? err : new Error(String(err));
+            throw createAuthError(err, 'update user data');
         }
     }
-    // ========================================
-    // UTILITY METHODS
-    // ========================================
+    // ── Utility ──────────────────────────────────────────────────────────────────
     /**
-     * Waits for authentication to initialize
-     * @returns {Promise<UserProfile | null>} Promise that resolves when auth is initialized
-     *
-     * @example
-     * ```typescript
-     * const user = await firekitUser.waitForAuth();
-     * if (user) {
-     *   console.log("User is authenticated");
-     * }
-     * ```
+     * Resolves once Firebase Auth has initialized (first `onAuthStateChanged` callback).
+     * Safe to call server-side — will resolve immediately with null.
      */
-    async waitForAuth() {
+    waitForAuth() {
+        if (this._initialized)
+            return Promise.resolve(this._user);
+        // $effect.root creates a reactive scope outside of component initialization,
+        // so this works safely whether called inside or outside a Svelte component.
         return new Promise((resolve) => {
-            if (this._initialized) {
-                resolve(this._user);
-                return;
-            }
-            // Create a one-time watcher
-            const checkInitialized = () => {
-                if (this._initialized) {
-                    resolve(this._user);
-                }
-                else {
-                    // Check again in next tick
-                    setTimeout(checkInitialized, 10);
-                }
-            };
-            checkInitialized();
+            const stop = $effect.root(() => {
+                $effect(() => {
+                    if (this._initialized) {
+                        stop();
+                        resolve(this._user);
+                    }
+                });
+            });
         });
     }
-    /**
-     * Clears any error state
-     */
     clearError() {
         this._error = null;
     }
-    /**
-     * Manually sets loading state (use with caution)
-     * @param {boolean} loading Loading state
-     */
-    setLoading(loading) {
-        this._loading = loading;
-    }
-    /**
-     * Resets the store to initial state
-     */
-    reset() {
-        this._user = null;
-        this._loading = true;
-        this._initialized = false;
-        this._error = null;
-        this._servicesInitialized = false;
-        this.auth = null;
-        this.firestore = null;
-    }
 }
-/**
- * Pre-initialized singleton instance of FirekitUserStore.
- * Provides reactive user state management for Svelte applications.
- *
- * @example
- * ```typescript
- * import { firekitUser } from 'svelte-firekit';
- *
- * // In a Svelte component
- * $: if (firekitUser.isAuthenticated) {
- *   console.log("Welcome:", firekitUser.displayName);
- * }
- *
- * // Update profile
- * await firekitUser.updateDisplayName("John Doe");
- *
- * // Get extended data
- * const userData = await firekitUser.getExtendedUserData();
- * ```
- */
 export const firekitUser = FirekitUserStore.getInstance();