svelte-firekit 0.2.3 → 0.2.5

package/dist/components/AuthGuard.svelte

@@ -45,9 +45,11 @@
 		return firekitAuth.signOut();
 	}
 
-	// React to auth state changes — runs whenever isAuthenticated or loading changes.
+	// Only react after Firebase Auth has fully initialized (first onAuthStateChanged callback).
+	// Uses `initialized` instead of `loading` because `loading` gets reused for profile
+	// updates and could cause false redirects mid-operation.
 	$effect(() => {
-		if (firekitUser.loading) return;
+		if (!firekitUser.initialized) return;
 
 		const isAuth = firekitUser.isAuthenticated;
 		const shouldBlock = requireAuth ? !isAuth : isAuth;
@@ -55,7 +57,7 @@
 	});
 </script>
 
-{#if firekitUser.loading}
+{#if !firekitUser.initialized}
 	{#if fallback}
 		{@render fallback()}
 	{/if}

package/dist/components/CustomGuard.svelte

@@ -53,8 +53,11 @@
 		}
 	}
 
+	// Only react after Firebase Auth has fully initialized (first onAuthStateChanged callback).
+	// Uses `initialized` instead of `loading` because `loading` gets reused for profile
+	// updates and could cause false redirects mid-operation.
 	$effect(() => {
-		if (firekitUser.loading) return;
+		if (!firekitUser.initialized) return;
 
 		const isAuth = firekitUser.isAuthenticated;
 		const shouldBlock = requireAuth ? !isAuth : isAuth;
@@ -78,7 +81,7 @@
 	});
 </script>
 
-{#if firekitUser.loading || isVerifying}
+{#if !firekitUser.initialized || isVerifying}
 	{#if fallback}
 		{@render fallback()}
 	{/if}

package/dist/components/FirebaseApp.svelte

@@ -8,6 +8,7 @@
 	import { firekitAppCheck } from '../services/app-check.svelte.js';
 	import { firekitAnalytics } from '../services/analytics.js';
 	import { firekitMessaging } from '../services/messaging.svelte.js';
+	import { firekitUser } from '../services/user.svelte.js';
 
 	/**
 	 * Root provider component. Initializes Firebase (and optionally App Check) and
@@ -75,6 +76,9 @@
 		setContext('firebase/app-check', firekitAppCheck.initialized ? firebaseService.appCheck : null);
 		setContext('firebase/analytics', firekitAnalytics);
 		setContext('firebase/messaging', firekitMessaging);
+
+		// Now that Firebase is configured, start the auth state listener.
+		firekitUser.initialize();
 	}
 </script>
 

package/dist/components/SignedIn.svelte

@@ -27,7 +27,7 @@
 	} = $props();
 </script>
 
-{#if firekitUser.loading}
+{#if !firekitUser.initialized}
 	{#if fallback}
 		{@render fallback()}
 	{/if}

package/dist/components/SignedOut.svelte

@@ -35,7 +35,7 @@
 	}
 </script>
 
-{#if firekitUser.loading}
+{#if !firekitUser.initialized}
 	{#if fallback}
 		{@render fallback()}
 	{/if}

package/dist/services/ai.svelte.js

@@ -210,7 +210,19 @@ export class FirekitChat {
         // Seed history from initialHistory
         for (const turn of initialHistory) {
             const text = turn.parts
-                .map((p) => ('text' in p ? p.text : ''))
+                .map((p) => {
+                if ('text' in p)
+                    return p.text;
+                if ('inlineData' in p)
+                    return '[image]';
+                if ('fileData' in p)
+                    return '[file]';
+                if ('functionCall' in p)
+                    return `[function: ${p.functionCall.name}]`;
+                if ('functionResponse' in p)
+                    return `[function response: ${p.functionResponse.name}]`;
+                return '[unknown part]';
+            })
                 .filter(Boolean)
                 .join('');
             this._history.push({

package/dist/services/analytics.js

@@ -41,7 +41,11 @@ class FirekitAnalytics {
             if (!supported)
                 return;
             this._analytics = getAnalytics(getApp());
-        })();
+        })().catch((err) => {
+            // Reset so next call retries instead of returning a rejected promise forever
+            this._initPromise = null;
+            throw err;
+        });
         return this._initPromise;
     }
     async _get() {

package/dist/services/auth.d.ts

@@ -18,8 +18,8 @@ declare class FirekitAuth {
     private recaptchaVerifiers;
     private constructor();
     static getInstance(): FirekitAuth;
-    private bootstrap;
     private getAuth;
+    private getFirestore;
     private syncToFirestore;
     private profile;
     signInWithEmail(email: string, password: string): Promise<SignInResult>;

package/dist/services/auth.js

@@ -20,9 +20,8 @@ class FirekitAuth {
     firestore = null;
     recaptchaVerifiers = new Map();
     constructor() {
-        if (typeof window !== 'undefined') {
-            this.bootstrap();
-        }
+        // Do NOT bootstrap here — Firebase config may not be set yet.
+        // Auth and Firestore instances are resolved lazily via getAuth() / getFirestore().
     }
     static getInstance() {
         if (!FirekitAuth.instance) {
@@ -30,20 +29,6 @@ class FirekitAuth {
         }
         return FirekitAuth.instance;
     }
-    bootstrap() {
-        try {
-            this.auth = firebaseService.getAuthInstance();
-            try {
-                this.firestore = firebaseService.getDbInstance();
-            }
-            catch {
-                this.firestore = null;
-            }
-        }
-        catch {
-            // Firebase not yet configured — services will be accessed lazily
-        }
-    }
     getAuth() {
         if (!this.auth) {
             this.auth = firebaseService.getAuthInstance();
@@ -53,10 +38,22 @@ class FirekitAuth {
         }
         return this.auth;
     }
+    getFirestore() {
+        if (!this.firestore) {
+            try {
+                this.firestore = firebaseService.getDbInstance();
+            }
+            catch {
+                this.firestore = null;
+            }
+        }
+        return this.firestore;
+    }
     async syncToFirestore(user) {
-        if (!this.firestore)
+        const fs = this.getFirestore();
+        if (!fs)
             return;
-        await updateUserInFirestore(this.firestore, user);
+        await updateUserInFirestore(fs, user);
     }
     profile(user) {
         return mapFirebaseUserToProfile(user);
@@ -327,9 +324,10 @@ class FirekitAuth {
             if (currentPassword)
                 await this.reauthenticate(currentPassword);
             // Soft-delete record in Firestore before removing auth
-            if (this.firestore) {
+            const fs = this.getFirestore();
+            if (fs) {
                 try {
-                    await setDoc(doc(this.firestore, 'users', user.uid), { deleted: true, deletedAt: serverTimestamp() }, { merge: true });
+                    await setDoc(doc(fs, 'users', user.uid), { deleted: true, deletedAt: serverTimestamp() }, { merge: true });
                 }
                 catch {
                     // Non-blocking
@@ -560,16 +558,22 @@ class FirekitAuth {
     }
     // ─── Utility getters ─────────────────────────────────────────────────────────
     getCurrentUser() {
-        return this.auth?.currentUser ?? null;
+        try {
+            return this.getAuth().currentUser;
+        }
+        catch {
+            return null;
+        }
     }
     isAuthenticated() {
-        return this.auth?.currentUser !== null && !this.auth?.currentUser?.isAnonymous;
+        const user = this.getCurrentUser();
+        return user !== null && !user.isAnonymous;
     }
     isAnonymous() {
-        return this.auth?.currentUser?.isAnonymous ?? false;
+        return this.getCurrentUser()?.isAnonymous ?? false;
     }
     isEmailVerified() {
-        return this.auth?.currentUser?.emailVerified ?? false;
+        return this.getCurrentUser()?.emailVerified ?? false;
     }
     async cleanup() {
         this.recaptchaVerifiers.forEach((v) => v.clear());

package/dist/services/messaging.svelte.d.ts

@@ -33,6 +33,7 @@ declare class FirekitMessaging {
     private _messaging;
     private _unsubscribeMessage;
     private _requesting;
+    private _listening;
     private constructor();
     static getInstance(): FirekitMessaging;
     get token(): string | null;

package/dist/services/messaging.svelte.js

@@ -40,6 +40,7 @@ class FirekitMessaging {
     _messaging = null;
     _unsubscribeMessage = null;
     _requesting = false;
+    _listening = false;
     constructor() {
         this._initPermissionState();
     }
@@ -161,7 +162,10 @@ class FirekitMessaging {
     }
     // ── Foreground messages ───────────────────────────────────────────────────
     _listenForMessages(msg) {
+        if (this._listening)
+            return;
         this._unsubscribeMessage?.();
+        this._listening = true;
         this._unsubscribeMessage = onMessage(msg, (payload) => {
             this._lastMessage = payload;
             this._messages = [...this._messages, payload];
@@ -185,6 +189,7 @@ class FirekitMessaging {
     dispose() {
         this._unsubscribeMessage?.();
         this._unsubscribeMessage = null;
+        this._listening = false;
     }
 }
 export const firekitMessaging = FirekitMessaging.getInstance();

package/dist/services/mutations.js

@@ -46,7 +46,7 @@ async function withRetry(fn, retryConfig) {
             }
         }
     }
-    throw lastError;
+    throw lastError instanceof Error ? lastError : new Error(String(lastError));
 }
 /**
  * Firestore document mutations — add, set, update, delete, batch, transaction.

package/dist/services/presence.svelte.d.ts

@@ -23,6 +23,7 @@ declare class FirekitPresence {
     private _geo;
     private _connectedUnsub;
     private _currentUser;
+    private _visibilityListenerAdded;
     private constructor();
     static getInstance(): FirekitPresence;
     get initialized(): boolean;

package/dist/services/presence.svelte.js

@@ -174,9 +174,11 @@ class FirekitPresence {
     _geo = null;
     _connectedUnsub = null;
     _currentUser = null;
+    _visibilityListenerAdded = false;
     constructor() {
         if (typeof window !== 'undefined') {
             document.addEventListener('visibilitychange', this._onVisibilityChange);
+            this._visibilityListenerAdded = true;
         }
     }
     static getInstance() {
@@ -236,10 +238,15 @@ class FirekitPresence {
         if (!db)
             throw new PresenceError(PresenceErrorCode.DATABASE_ERROR, 'Realtime Database is not initialized.');
         const connectedRef = ref(db, '.info/connected');
-        this._connectedUnsub = onValue(connectedRef, async (snap) => {
+        this._connectedUnsub = onValue(connectedRef, (snap) => {
             if (snap.val() === true) {
-                await this.setPresence('online');
-                await this._setupDisconnectHandler();
+                this.setPresence('online')
+                    .then(() => this._setupDisconnectHandler())
+                    .catch((err) => {
+                    this._error = err instanceof PresenceError
+                        ? err
+                        : new PresenceError(PresenceErrorCode.DATABASE_ERROR, err.message, err);
+                });
             }
             else {
                 this._status = 'offline';
@@ -377,8 +384,9 @@ class FirekitPresence {
         this._geo?.dispose();
         this._connectedUnsub?.();
         this._connectedUnsub = null;
-        if (typeof document !== 'undefined') {
+        if (this._visibilityListenerAdded) {
             document.removeEventListener('visibilitychange', this._onVisibilityChange);
+            this._visibilityListenerAdded = false;
         }
         this._initialized = false;
         this._status = 'offline';

package/dist/services/remote-config.svelte.js

@@ -92,6 +92,9 @@ export class FirekitRemoteConfig {
             },
             error: (err) => {
                 this._error = err instanceof Error ? err : new Error(String(err));
+                // Clean up the broken subscription so it doesn't keep firing errors
+                this._unsubscribe?.();
+                this._unsubscribe = null;
             },
             complete: () => { }
         });

package/dist/services/storage.svelte.js

@@ -197,6 +197,7 @@ export class FirekitUploadTask {
                 if (this._storageRef) {
                     this._downloadURL = await getDownloadURL(this._storageRef);
                 }
+                this._error = null;
                 this._state = 'success';
                 this._progress = 100;
             });

package/dist/services/user.svelte.d.ts

@@ -36,9 +36,20 @@ declare class FirekitUserStore {
     private _photoURL;
     private _uid;
     private _phoneNumber;
+    private _listening;
     private constructor();
     static getInstance(): FirekitUserStore;
-    private bootstrap;
+    /**
+     * Called by FirebaseApp after initFirekit() to start the auth listener.
+     * Safe to call multiple times — only the first call has an effect.
+     */
+    initialize(): void;
+    /**
+     * Ensures the onAuthStateChanged listener is registered.
+     * Called lazily from initialize() or from any public getter/method
+     * so the store self-heals if Firebase was configured after import.
+     */
+    private ensureListening;
     private listenToAuthState;
     private syncToFirestore;
     private currentFirebaseUser;
@@ -66,9 +77,10 @@ declare class FirekitUserStore {
     updateExtendedData(data: Partial<ExtendedUserData>): Promise<void>;
     /**
      * Resolves once Firebase Auth has initialized (first `onAuthStateChanged` callback).
+     * Rejects after `timeoutMs` (default 10 000 ms) if auth never initializes.
      * Safe to call server-side — will resolve immediately with null.
      */
-    waitForAuth(): Promise<UserProfile | null>;
+    waitForAuth(timeoutMs?: number): Promise<UserProfile | null>;
     clearError(): void;
 }
 export declare const firekitUser: FirekitUserStore;

package/dist/services/user.svelte.js

@@ -34,10 +34,10 @@ class FirekitUserStore {
     _photoURL = $derived(this._user?.photoURL ?? null);
     _uid = $derived(this._user?.uid ?? null);
     _phoneNumber = $derived(this._user?.phoneNumber ?? null);
+    _listening = false;
     constructor() {
-        if (typeof window !== 'undefined') {
-            this.bootstrap();
-        }
+        // Do NOT bootstrap here — Firebase config may not be set yet.
+        // Auth listener is set up lazily via initialize() or ensureListening().
     }
     static getInstance() {
         if (!FirekitUserStore.instance) {
@@ -45,7 +45,23 @@ class FirekitUserStore {
         }
         return FirekitUserStore.instance;
     }
-    bootstrap() {
+    /**
+     * Called by FirebaseApp after initFirekit() to start the auth listener.
+     * Safe to call multiple times — only the first call has an effect.
+     */
+    initialize() {
+        if (typeof window === 'undefined')
+            return;
+        this.ensureListening();
+    }
+    /**
+     * Ensures the onAuthStateChanged listener is registered.
+     * Called lazily from initialize() or from any public getter/method
+     * so the store self-heals if Firebase was configured after import.
+     */
+    ensureListening() {
+        if (this._listening)
+            return;
         try {
             this.auth = firebaseService.getAuthInstance();
             try {
@@ -54,12 +70,11 @@ class FirekitUserStore {
             catch {
                 this.firestore = null;
             }
+            this._listening = true;
             this.listenToAuthState();
         }
-        catch (err) {
-            this._error = err instanceof Error ? err : new Error(String(err));
-            this._loading = false;
-            this._initialized = true;
+        catch {
+            // Firebase not yet configured — will retry on next access
         }
     }
     listenToAuthState() {
@@ -85,18 +100,20 @@ class FirekitUserStore {
         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; }
+    // Each getter calls ensureListening() so the auth listener is registered
+    // on first access, even if initialize() hasn't been called yet.
+    get user() { this.ensureListening(); return this._user; }
+    get loading() { this.ensureListening(); return this._loading; }
+    get initialized() { this.ensureListening(); return this._initialized; }
+    get error() { this.ensureListening(); return this._error; }
+    get isAuthenticated() { this.ensureListening(); return this._isAuthenticated; }
+    get isAnonymous() { this.ensureListening(); return this._isAnonymous; }
+    get isEmailVerified() { this.ensureListening(); return this._isEmailVerified; }
+    get email() { this.ensureListening(); return this._email; }
+    get displayName() { this.ensureListening(); return this._displayName; }
+    get photoURL() { this.ensureListening(); return this._photoURL; }
+    get uid() { this.ensureListening(); return this._uid; }
+    get phoneNumber() { this.ensureListening(); return this._phoneNumber; }
     // ── Profile updates ──────────────────────────────────────────────────────────
     async updateDisplayName(displayName) {
         const user = this.currentFirebaseUser();
@@ -253,17 +270,24 @@ class FirekitUserStore {
     // ── Utility ──────────────────────────────────────────────────────────────────
     /**
      * Resolves once Firebase Auth has initialized (first `onAuthStateChanged` callback).
+     * Rejects after `timeoutMs` (default 10 000 ms) if auth never initializes.
      * Safe to call server-side — will resolve immediately with null.
      */
-    waitForAuth() {
+    waitForAuth(timeoutMs = 10_000) {
+        if (typeof window === 'undefined')
+            return Promise.resolve(null);
+        this.ensureListening();
         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) => {
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                stop();
+                reject(new Error('waitForAuth timed out — Firebase Auth did not initialize.'));
+            }, timeoutMs);
             const stop = $effect.root(() => {
                 $effect(() => {
                     if (this._initialized) {
+                        clearTimeout(timer);
                         stop();
                         resolve(this._user);
                     }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "svelte-firekit",
-	"version": "0.2.3",
+	"version": "0.2.5",
 	"description": "A Svelte library for Firebase integration",
 	"license": "MIT",
 	"author": "Giovani Rodriguez",