svelte-firekit 0.1.5 → 0.1.7

package/dist/services/auth.js

@@ -3,7 +3,7 @@
  * @module FirekitAuth
  * @version 1.0.0
  */
-import { EmailAuthProvider, PhoneAuthProvider, RecaptchaVerifier, signInWithEmailAndPassword, signInWithPopup, signInWithPhoneNumber as firebaseSignInWithPhoneNumber, signInWithCredential, signInAnonymously as firebaseSignInAnonymously, createUserWithEmailAndPassword, signOut, sendPasswordResetEmail, confirmPasswordReset, sendEmailVerification, updateProfile, updateEmail, updatePassword, reauthenticateWithCredential, deleteUser, reload, getIdToken, onAuthStateChanged } from 'firebase/auth';
+import { EmailAuthProvider, PhoneAuthProvider, RecaptchaVerifier, signInWithEmailAndPassword, signInWithPopup, signInWithPhoneNumber as firebaseSignInWithPhoneNumber, signInWithCredential, signInAnonymously as firebaseSignInAnonymously, createUserWithEmailAndPassword, signOut, sendPasswordResetEmail, confirmPasswordReset, sendEmailVerification, updateProfile, updateEmail, updatePassword, reauthenticateWithCredential, deleteUser, reload, getIdToken, onAuthStateChanged, getAdditionalUserInfo } from 'firebase/auth';
 import { doc, setDoc, serverTimestamp } from 'firebase/firestore';
 import { firebaseService } from '../firebase.js';
 import { AuthErrorCode, FirekitAuthError } from '../types/auth.js';
@@ -205,14 +205,15 @@ class FirekitAuth {
      * Signs in user with email and password
      * @param {string} email User's email address
      * @param {string} password User's password
-     * @returns {Promise<UserProfile>} Promise resolving to user profile
+     * @returns {Promise<SignInResult>} Promise resolving to sign-in result
      * @throws {FirekitAuthError} If sign-in fails
      *
      * @example
      * ```typescript
      * try {
-     *   const user = await firekitAuth.signInWithEmail("user@example.com", "password123");
-     *   console.log("Signed in:", user.displayName);
+     *   const result = await firekitAuth.signInWithEmail("user@example.com", "password123");
+     *   console.log("Signed in:", result.user.displayName);
+     *   console.log("Is new user:", result.isNewUser);
      * } catch (error) {
      *   console.error("Sign-in failed:", error.message);
      * }
@@ -227,7 +228,17 @@ class FirekitAuth {
             this.notifyStateListeners();
             const userCredential = await signInWithEmailAndPassword(this.auth, email, password);
             await this.updateUserInFirestore(userCredential.user);
-            return this.mapFirebaseUserToProfile(userCredential.user);
+            const userProfile = this.mapFirebaseUserToProfile(userCredential.user);
+            const additionalUserInfo = getAdditionalUserInfo(userCredential);
+            const isNewUser = additionalUserInfo?.isNewUser ?? false;
+            return {
+                success: true,
+                user: userProfile,
+                method: 'email',
+                timestamp: new Date(),
+                isNewUser,
+                requiresEmailVerification: !userProfile.emailVerified
+            };
         }
         catch (error) {
             this.handleAuthError(error);
@@ -239,14 +250,16 @@ class FirekitAuth {
     }
     /**
      * Signs in user with Google popup
-     * @returns {Promise<UserProfile>} Promise resolving to user profile
+     * @returns {Promise<OAuthSignInResult>} Promise resolving to OAuth sign-in result
      * @throws {FirekitAuthError} If sign-in fails
      *
      * @example
      * ```typescript
      * try {
-     *   const user = await firekitAuth.signInWithGoogle();
-     *   console.log("Signed in with Google:", user.email);
+     *   const result = await firekitAuth.signInWithGoogle();
+     *   console.log("Signed in with Google:", result.user.email);
+     *   console.log("Is new user:", result.isNewUser);
+     *   console.log("Access token:", result.accessToken);
      * } catch (error) {
      *   if (error.code === 'auth/popup-closed-by-user') {
      *     console.log("User cancelled sign-in");
@@ -264,7 +277,17 @@ class FirekitAuth {
             const provider = createGoogleProvider();
             const result = await signInWithPopup(this.auth, provider);
             await this.updateUserInFirestore(result.user);
-            return this.mapFirebaseUserToProfile(result.user);
+            const userProfile = this.mapFirebaseUserToProfile(result.user);
+            const additionalUserInfo = getAdditionalUserInfo(result);
+            const isNewUser = additionalUserInfo?.isNewUser ?? false;
+            return {
+                success: true,
+                user: userProfile,
+                method: 'google',
+                timestamp: new Date(),
+                isNewUser,
+                provider: 'google'
+            };
         }
         catch (error) {
             this.handleAuthError(error);
@@ -276,7 +299,7 @@ class FirekitAuth {
     }
     /**
      * Signs in user with Facebook popup
-     * @returns {Promise<UserProfile>} Promise resolving to user profile
+     * @returns {Promise<OAuthSignInResult>} Promise resolving to OAuth sign-in result
      * @throws {FirekitAuthError} If sign-in fails
      */
     async signInWithFacebook() {
@@ -289,7 +312,17 @@ class FirekitAuth {
             const provider = createFacebookProvider();
             const result = await signInWithPopup(this.auth, provider);
             await this.updateUserInFirestore(result.user);
-            return this.mapFirebaseUserToProfile(result.user);
+            const userProfile = this.mapFirebaseUserToProfile(result.user);
+            const additionalUserInfo = getAdditionalUserInfo(result);
+            const isNewUser = additionalUserInfo?.isNewUser ?? false;
+            return {
+                success: true,
+                user: userProfile,
+                method: 'facebook',
+                timestamp: new Date(),
+                isNewUser,
+                provider: 'facebook'
+            };
         }
         catch (error) {
             this.handleAuthError(error);
@@ -301,7 +334,7 @@ class FirekitAuth {
     }
     /**
      * Signs in user with Apple popup
-     * @returns {Promise<UserProfile>} Promise resolving to user profile
+     * @returns {Promise<OAuthSignInResult>} Promise resolving to OAuth sign-in result
      * @throws {FirekitAuthError} If sign-in fails
      */
     async signInWithApple() {
@@ -314,7 +347,17 @@ class FirekitAuth {
             const provider = createAppleProvider();
             const result = await signInWithPopup(this.auth, provider);
             await this.updateUserInFirestore(result.user);
-            return this.mapFirebaseUserToProfile(result.user);
+            const userProfile = this.mapFirebaseUserToProfile(result.user);
+            const additionalUserInfo = getAdditionalUserInfo(result);
+            const isNewUser = additionalUserInfo?.isNewUser ?? false;
+            return {
+                success: true,
+                user: userProfile,
+                method: 'apple',
+                timestamp: new Date(),
+                isNewUser,
+                provider: 'apple'
+            };
         }
         catch (error) {
             this.handleAuthError(error);
@@ -326,13 +369,14 @@ class FirekitAuth {
     }
     /**
      * Signs in user anonymously
-     * @returns {Promise<UserProfile>} Promise resolving to user profile
+     * @returns {Promise<SignInResult>} Promise resolving to sign-in result
      * @throws {FirekitAuthError} If sign-in fails
      *
      * @example
      * ```typescript
-     * const user = await firekitAuth.signInAnonymously();
-     * console.log("Anonymous user:", user.uid);
+     * const result = await firekitAuth.signInAnonymously();
+     * console.log("Anonymous user:", result.user.uid);
+     * console.log("Is new user:", result.isNewUser);
      * ```
      */
     async signInAnonymously() {
@@ -344,7 +388,16 @@ class FirekitAuth {
             this.notifyStateListeners();
             const result = await firebaseSignInAnonymously(this.auth);
             await this.updateUserInFirestore(result.user);
-            return this.mapFirebaseUserToProfile(result.user);
+            const userProfile = this.mapFirebaseUserToProfile(result.user);
+            const additionalUserInfo = getAdditionalUserInfo(result);
+            const isNewUser = additionalUserInfo?.isNewUser ?? false;
+            return {
+                success: true,
+                user: userProfile,
+                method: 'anonymous',
+                timestamp: new Date(),
+                isNewUser
+            };
         }
         catch (error) {
             this.handleAuthError(error);
@@ -397,7 +450,16 @@ class FirekitAuth {
                     try {
                         const userCredential = await confirmationResult.confirm(verificationCode);
                         await this.updateUserInFirestore(userCredential.user);
-                        return this.mapFirebaseUserToProfile(userCredential.user);
+                        const userProfile = this.mapFirebaseUserToProfile(userCredential.user);
+                        const additionalUserInfo = getAdditionalUserInfo(userCredential);
+                        const isNewUser = additionalUserInfo?.isNewUser ?? false;
+                        return {
+                            success: true,
+                            user: userProfile,
+                            method: 'phone',
+                            timestamp: new Date(),
+                            isNewUser
+                        };
                     }
                     catch (error) {
                         this.handleAuthError(error);
@@ -427,17 +489,18 @@ class FirekitAuth {
      * @param {string} password User's password
      * @param {string} [displayName] User's display name
      * @param {boolean} [sendVerification=true] Whether to send email verification
-     * @returns {Promise<UserProfile>} Promise resolving to user profile
+     * @returns {Promise<RegistrationResult>} Promise resolving to registration result
      * @throws {FirekitAuthError} If registration fails
      *
      * @example
      * ```typescript
-     * const user = await firekitAuth.registerWithEmail(
+     * const result = await firekitAuth.registerWithEmail(
      *   "user@example.com",
      *   "password123",
      *   "John Doe"
      * );
-     * console.log("Registered:", user.displayName);
+     * console.log("Registered:", result.user.displayName);
+     * console.log("Email verification sent:", result.emailVerificationSent);
      * ```
      */
     async registerWithEmail(email, password, displayName, sendVerification = true) {
@@ -458,7 +521,15 @@ class FirekitAuth {
                 await sendEmailVerification(user);
             }
             await this.updateUserInFirestore(user);
-            return this.mapFirebaseUserToProfile(user);
+            const userProfile = this.mapFirebaseUserToProfile(user);
+            return {
+                success: true,
+                user: userProfile,
+                method: 'email',
+                timestamp: new Date(),
+                emailVerificationSent: sendVerification,
+                requiresEmailVerification: !userProfile.emailVerified
+            };
         }
         catch (error) {
             this.handleAuthError(error);

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

@@ -4,7 +4,7 @@
  * @version 1.0.0
  */
 import { type Query, type CollectionReference, type DocumentData, type QueryConstraint } from 'firebase/firestore';
-import { type CollectionState, type CollectionOptions, type CollectionEventCallback, type CollectionStats, type QueryBuilder, CollectionError } from '../types/collection.js';
+import { type CollectionState, type CollectionOptions, type CollectionStats, type QueryBuilder, CollectionError } from '../types/collection.js';
 /**
  * Comprehensive Firestore collection management with real-time updates and advanced features.
  * Uses Svelte 5 runes for optimal reactivity and performance.
@@ -57,7 +57,6 @@ declare class FirekitCollection<T extends DocumentData = DocumentData> {
     private collectionRef;
     protected queryRef: Query<T> | null;
     private unsubscribe;
-    private eventListeners;
     protected options: CollectionOptions;
     private stats;
     private cache;
@@ -118,10 +117,6 @@ declare class FirekitCollection<T extends DocumentData = DocumentData> {
      * Calculate memory usage of documents
      */
     private calculateMemoryUsage;
-    /**
-     * Emit event to all listeners
-     */
-    private emitEvent;
     /**
      * Get current collection data
      */
@@ -242,14 +237,6 @@ declare class FirekitCollection<T extends DocumentData = DocumentData> {
      * Reset statistics
      */
     resetStats(): void;
-    /**
-     * Add event listener
-     */
-    addEventListener(callback: CollectionEventCallback<T>): () => void;
-    /**
-     * Remove all event listeners
-     */
-    clearEventListeners(): void;
     /**
      * Wait for collection to initialize
      */

package/dist/services/collection.svelte.js

@@ -98,7 +98,6 @@ class FirekitCollection {
     collectionRef = null;
     queryRef = null;
     unsubscribe = null;
-    eventListeners = new Set();
     options;
     stats = this.initializeStats();
     cache = new Map();
@@ -158,12 +157,6 @@ class FirekitCollection {
                 this._loading = false;
                 this._initialized = true;
                 this._lastUpdated = cached.timestamp;
-                this.emitEvent({
-                    type: 'cache_hit',
-                    data: cached.data,
-                    timestamp: new Date(),
-                    path: this.collectionPath
-                });
                 this.stats.cacheHitRate = (this.stats.cacheHitRate + 1) / 2;
             }
             // Create collection reference
@@ -189,11 +182,6 @@ class FirekitCollection {
     setupRealtimeListener() {
         if (!this.queryRef)
             return;
-        this.emitEvent({
-            type: 'loading_started',
-            timestamp: new Date(),
-            path: this.collectionPath
-        });
         const options = {
             includeMetadataChanges: this.options.includeMetadata || false
         };
@@ -211,11 +199,6 @@ class FirekitCollection {
             return;
         try {
             this._loading = true;
-            this.emitEvent({
-                type: 'loading_started',
-                timestamp: new Date(),
-                path: this.collectionPath
-            });
             const startTime = Date.now();
             const snapshot = await getDocs(this.queryRef);
             const queryTime = Date.now() - startTime;
@@ -271,33 +254,6 @@ class FirekitCollection {
                 });
                 this.cleanupCache();
             }
-            // Emit events
-            this.emitEvent({
-                type: 'data_changed',
-                data: documents,
-                changes,
-                timestamp: new Date(),
-                path: this.collectionPath
-            });
-            this.emitEvent({
-                type: 'loading_finished',
-                data: {
-                    documentCount: documents.length,
-                    processingTime: Date.now() - startTime
-                },
-                timestamp: new Date(),
-                path: this.collectionPath
-            });
-            // Emit individual change events
-            changes.forEach((change) => {
-                this.emitEvent({
-                    type: `document_${change.type}`,
-                    data: change.doc,
-                    changes: [change],
-                    timestamp: new Date(),
-                    path: this.collectionPath
-                });
-            });
         }
         catch (error) {
             this.handleError(error);
@@ -365,12 +321,6 @@ class FirekitCollection {
         }
         this._error = collectionError;
         this._loading = false;
-        this.emitEvent({
-            type: 'error',
-            error: collectionError,
-            timestamp: new Date(),
-            path: this.collectionPath
-        });
         console.error('FirekitCollection error:', collectionError);
     }
     /**
@@ -469,19 +419,6 @@ class FirekitCollection {
             return 0;
         }
     }
-    /**
-     * Emit event to all listeners
-     */
-    emitEvent(event) {
-        this.eventListeners.forEach((callback) => {
-            try {
-                callback(event);
-            }
-            catch (error) {
-                console.error('Error in collection event listener:', error);
-            }
-        });
-    }
     // ========================================
     // REACTIVE GETTERS (Public API)
     // ========================================
@@ -736,22 +673,6 @@ class FirekitCollection {
     resetStats() {
         this.stats = this.initializeStats();
     }
-    // ========================================
-    // EVENT MANAGEMENT
-    // ========================================
-    /**
-     * Add event listener
-     */
-    addEventListener(callback) {
-        this.eventListeners.add(callback);
-        return () => this.eventListeners.delete(callback);
-    }
-    /**
-     * Remove all event listeners
-     */
-    clearEventListeners() {
-        this.eventListeners.clear();
-    }
     /**
      * Wait for collection to initialize
      */
@@ -761,12 +682,18 @@ class FirekitCollection {
                 resolve(this._data);
                 return;
             }
-            const unsubscribe = this.addEventListener((event) => {
-                if (event.type === 'data_changed' || event.type === 'error') {
-                    unsubscribe();
+            // Poll for initialization since we removed events
+            const checkInterval = setInterval(() => {
+                if (this._initialized) {
+                    clearInterval(checkInterval);
                     resolve(this._data);
                 }
-            });
+            }, 100);
+            // Timeout after 10 seconds
+            setTimeout(() => {
+                clearInterval(checkInterval);
+                resolve(this._data);
+            }, 10000);
         });
     }
     // ========================================
@@ -783,8 +710,6 @@ class FirekitCollection {
         }
         // Clear cache
         this.cache.clear();
-        // Clear event listeners
-        this.eventListeners.clear();
         // Reset state
         this._data = [];
         this._loading = false;

package/dist/services/index.d.ts

@@ -0,0 +1,9 @@
+export { firekitCollection, firekitCollectionOnce, firekitCollectionGroup } from './collection.svelte.js';
+export { firekitDoc, firekitDocOnce, firekitDocWithMetadata } from './document.svelte.js';
+export { firekitUser } from './user.svelte.js';
+export { firekitAuth } from './auth.js';
+export { firekitDownloadUrl, firekitStorageList, firekitUploadTask } from './storage.svelte.js';
+export { firekitPresence } from './presence.svelte.js';
+export { firekitRealtimeDB, firekitRealtimeList } from './realtime.svelte.js';
+export { firekitDocMutations } from './mutations.js';
+export { firekitAnalytics } from './analytics.js';

package/dist/services/index.js

@@ -0,0 +1,10 @@
+// Export all svelte-firekit services
+export { firekitCollection, firekitCollectionOnce, firekitCollectionGroup } from './collection.svelte.js';
+export { firekitDoc, firekitDocOnce, firekitDocWithMetadata } from './document.svelte.js';
+export { firekitUser } from './user.svelte.js';
+export { firekitAuth } from './auth.js';
+export { firekitDownloadUrl, firekitStorageList, firekitUploadTask } from './storage.svelte.js';
+export { firekitPresence } from './presence.svelte.js';
+export { firekitRealtimeDB, firekitRealtimeList } from './realtime.svelte.js';
+export { firekitDocMutations } from './mutations.js';
+export { firekitAnalytics } from './analytics.js';

package/dist/services/mutations.d.ts

@@ -4,7 +4,7 @@
  * @version 1.0.0
  */
 import { type DocumentData, type WithFieldValue, type PartialWithFieldValue } from 'firebase/firestore';
-import { type MutationResponse, type MutationOptions, type BatchOperation, type BatchResult, type ExistenceCheckResult, type BulkMutationConfig, type MutationEventCallback, type MutationAnalytics } from '../types/mutations.js';
+import { type MutationResponse, type MutationOptions, type BatchOperation, type BatchResult, type ExistenceCheckResult, type BulkMutationConfig, type MutationAnalytics } from '../types/mutations.js';
 /**
  * Comprehensive Firestore document mutation service with advanced features.
  * Handles CRUD operations, batch processing, validation, error handling, and analytics.
@@ -28,15 +28,9 @@ import { type MutationResponse, type MutationOptions, type BatchOperation, type
  *   { type: 'create', path: 'users', data: userData },
  *   { type: 'update', path: 'profiles/123', data: profileUpdate }
  * ]);
- *
- * // Listen to mutation events
- * const unsubscribe = firekitDocMutations.addEventListener((event) => {
- *   console.log('Mutation event:', event.type, event.data);
- * });
  * ```
  */
 declare class FirekitDocumentMutations {
-    private eventListeners;
     private analytics;
     private defaultOptions;
     /**
@@ -63,10 +57,6 @@ declare class FirekitDocumentMutations {
      * Update error analytics
      */
     private updateErrorAnalytics;
-    /**
-     * Emit event to all listeners
-     */
-    private emitEvent;
     /**
      * Execute operation with retry logic
      */
@@ -216,6 +206,10 @@ declare class FirekitDocumentMutations {
      * Add operation to batch writer
      */
     private addOperationToBatch;
+    /**
+     * Generate a unique document ID (Firestore-style)
+     */
+    private generateDocumentId;
     /**
      * Chunk array into smaller arrays
      */
@@ -255,27 +249,6 @@ declare class FirekitDocumentMutations {
      * Update operation analytics
      */
     private updateOperationAnalytics;
-    /**
-     * Add event listener for mutation events
-     *
-     * @param callback Event callback function
-     * @returns Cleanup function to remove listener
-     *
-     * @example
-     * ```typescript
-     * const unsubscribe = firekitDocMutations.addEventListener((event) => {
-     *   console.log('Mutation event:', event.type, event.data);
-     * });
-     *
-     * // Clean up when done
-     * unsubscribe();
-     * ```
-     */
-    addEventListener(callback: MutationEventCallback): () => void;
-    /**
-     * Remove all event listeners
-     */
-    clearEventListeners(): void;
     /**
      * Get current mutation analytics
      *
@@ -325,11 +298,6 @@ declare class FirekitDocumentMutations {
  *   { type: 'create', path: 'users', data: userData },
  *   { type: 'update', path: 'profiles/123', data: updateData }
  * ]);
- *
- * // Listen to events
- * const unsubscribe = firekitDocMutations.addEventListener((event) => {
- *   console.log('Mutation:', event.type, event.data);
- * });
  * ```
  */
 export declare const firekitDocMutations: FirekitDocumentMutations;