svelte-firekit 0.1.5 → 0.1.6

package/dist/services/mutations.js

@@ -31,15 +31,9 @@ import { CacheSource } from '../types/document.js';
  *   { 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);
- * });
  * ```
  */
 class FirekitDocumentMutations {
-    eventListeners = new Set();
     analytics = this.initializeAnalytics();
     defaultOptions = {
         timestamps: true,
@@ -132,13 +126,6 @@ class FirekitDocumentMutations {
         // Update analytics
         this.analytics.failedMutations++;
         this.updateErrorAnalytics(mutationError);
-        // Emit error event
-        this.emitEvent({
-            type: 'mutation_error',
-            error: mutationError,
-            timestamp: new Date(),
-            userId: firekitUser.uid ?? 'anonymous'
-        });
         console.error('FirekitDocumentMutations error:', mutationError);
         return mutationError;
     }
@@ -200,19 +187,6 @@ class FirekitDocumentMutations {
         // Sort by count
         this.analytics.commonErrors.sort((a, b) => b.count - a.count);
     }
-    /**
-     * Emit event to all listeners
-     */
-    emitEvent(event) {
-        this.eventListeners.forEach((callback) => {
-            try {
-                callback(event);
-            }
-            catch (error) {
-                console.error('Error in mutation event listener:', error);
-            }
-        });
-    }
     /**
      * Execute operation with retry logic
      */
@@ -223,12 +197,6 @@ class FirekitDocumentMutations {
         while (attempt < retryConfig.maxAttempts) {
             try {
                 if (attempt > 0) {
-                    this.emitEvent({
-                        type: 'mutation_retry',
-                        data: { attempt, maxAttempts: retryConfig.maxAttempts, operation: operationName, path },
-                        timestamp: new Date(),
-                        userId: firekitUser.uid ?? 'anonymous'
-                    });
                     this.analytics.retryStats.totalRetries++;
                 }
                 const result = await operation();
@@ -288,13 +256,6 @@ class FirekitDocumentMutations {
         const startTime = Date.now();
         const mergedOptions = { ...this.defaultOptions, ...options };
         try {
-            // Emit start event
-            this.emitEvent({
-                type: 'mutation_start',
-                data: { operation: 'create', path: collectionPath, data },
-                timestamp: new Date(),
-                userId: firekitUser.uid ?? 'anonymous'
-            });
             // Validate data if requested
             if (mergedOptions.validate) {
                 const validation = this.validateData(data, mergedOptions.validator);
@@ -340,13 +301,6 @@ class FirekitDocumentMutations {
             this.analytics.totalMutations++;
             this.analytics.successfulMutations++;
             this.updateOperationAnalytics(MutationOperationType.CREATE, Date.now() - startTime, true);
-            // Emit success event
-            this.emitEvent({
-                type: 'mutation_success',
-                data: { operation: 'create', path: collectionPath, result },
-                timestamp: new Date(),
-                userId: firekitUser.uid ?? 'anonymous'
-            });
             return result;
         }
         catch (error) {
@@ -392,12 +346,6 @@ class FirekitDocumentMutations {
         const startTime = Date.now();
         const mergedOptions = { ...this.defaultOptions, ...options };
         try {
-            this.emitEvent({
-                type: 'mutation_start',
-                data: { operation: 'set', path, data },
-                timestamp: new Date(),
-                userId: firekitUser.uid ?? 'anonymous'
-            });
             if (mergedOptions.validate) {
                 const validation = this.validateData(data, mergedOptions.validator);
                 if (!validation.valid) {
@@ -432,12 +380,6 @@ class FirekitDocumentMutations {
             this.analytics.totalMutations++;
             this.analytics.successfulMutations++;
             this.updateOperationAnalytics(MutationOperationType.SET, Date.now() - startTime, true);
-            this.emitEvent({
-                type: 'mutation_success',
-                data: { operation: 'set', path, result },
-                timestamp: new Date(),
-                userId: firekitUser.uid ?? 'anonymous'
-            });
             return result;
         }
         catch (error) {
@@ -480,12 +422,6 @@ class FirekitDocumentMutations {
         const startTime = Date.now();
         const mergedOptions = { ...this.defaultOptions, ...options };
         try {
-            this.emitEvent({
-                type: 'mutation_start',
-                data: { operation: 'update', path, data },
-                timestamp: new Date(),
-                userId: firekitUser.uid ?? 'anonymous'
-            });
             if (mergedOptions.validate) {
                 const validation = this.validateData(data, mergedOptions.validator);
                 if (!validation.valid) {
@@ -502,6 +438,7 @@ class FirekitDocumentMutations {
                     ...data,
                     ...(mergedOptions.timestamps && this.getTimestampData(false))
                 };
+                // @ts-ignore
                 await updateDoc(docRef, dataToUpdate);
                 return {
                     success: true,
@@ -519,12 +456,6 @@ class FirekitDocumentMutations {
             this.analytics.totalMutations++;
             this.analytics.successfulMutations++;
             this.updateOperationAnalytics(MutationOperationType.UPDATE, Date.now() - startTime, true);
-            this.emitEvent({
-                type: 'mutation_success',
-                data: { operation: 'update', path, result },
-                timestamp: new Date(),
-                userId: firekitUser.uid ?? 'anonymous'
-            });
             return result;
         }
         catch (error) {
@@ -565,12 +496,6 @@ class FirekitDocumentMutations {
         const startTime = Date.now();
         const mergedOptions = { ...this.defaultOptions, ...options };
         try {
-            this.emitEvent({
-                type: 'mutation_start',
-                data: { operation: 'delete', path },
-                timestamp: new Date(),
-                userId: firekitUser.uid ?? 'anonymous'
-            });
             const result = await this.executeWithRetry(async () => {
                 const firestore = firebaseService.getDbInstance();
                 if (!firestore) {
@@ -593,12 +518,6 @@ class FirekitDocumentMutations {
             this.analytics.totalMutations++;
             this.analytics.successfulMutations++;
             this.updateOperationAnalytics(MutationOperationType.DELETE, Date.now() - startTime, true);
-            this.emitEvent({
-                type: 'mutation_success',
-                data: { operation: 'delete', path, result },
-                timestamp: new Date(),
-                userId: firekitUser.uid ?? 'anonymous'
-            });
             return result;
         }
         catch (error) {
@@ -696,17 +615,12 @@ class FirekitDocumentMutations {
     async batch(operations, config = {}) {
         const startTime = Date.now();
         const batchConfig = {
-            batchSize: 500,
             parallel: false,
             failFast: true,
-            ...config
+            ...config,
+            // Enforce Firestore limit of 500 operations per batch
+            batchSize: Math.min(config.batchSize || 500, 500)
         };
-        this.emitEvent({
-            type: 'batch_start',
-            data: { operationCount: operations.length, config: batchConfig },
-            timestamp: new Date(),
-            userId: firekitUser.uid ?? 'anonymous'
-        });
         try {
             const firestore = firebaseService.getDbInstance();
             if (!firestore) {
@@ -754,15 +668,7 @@ class FirekitDocumentMutations {
                         successCount++;
                 });
                 results.push(...batchResults);
-                // Emit progress
-                const completed = (i + 1) * batchConfig.batchSize;
-                this.emitEvent({
-                    type: 'batch_progress',
-                    data: { completed: Math.min(completed, operations.length), total: operations.length },
-                    timestamp: new Date(),
-                    userId: firekitUser.uid ?? 'anonymous'
-                });
-                batchConfig.onProgress?.(Math.min(completed, operations.length), operations.length);
+                batchConfig.onProgress?.(Math.min((i + 1) * batchConfig.batchSize, operations.length), operations.length);
             }
             const batchResult = {
                 success: failureCount === 0,
@@ -778,12 +684,6 @@ class FirekitDocumentMutations {
                     strategy: batchConfig.parallel ? 'parallel' : 'sequential'
                 }
             };
-            this.emitEvent({
-                type: 'batch_complete',
-                data: batchResult,
-                timestamp: new Date(),
-                userId: firekitUser.uid ?? 'anonymous'
-            });
             return batchResult;
         }
         catch (error) {
@@ -800,7 +700,32 @@ class FirekitDocumentMutations {
             throw new Error('Firestore not available');
         const options = { ...this.defaultOptions, ...operation.options };
         switch (operation.type) {
-            case 'create':
+            case 'create': {
+                let data = operation.data || {};
+                if (options.timestamps) {
+                    data = { ...data, ...this.getTimestampData() };
+                }
+                if (options.validate && operation.data) {
+                    const validation = this.validateData(operation.data, options.validator);
+                    if (!validation.valid) {
+                        throw new MutationError(MutationErrorCode.VALIDATION_FAILED, validation.message || 'Validation failed', operation.type, operation.path);
+                    }
+                }
+                // For CREATE operations, use addDoc if no custom ID, otherwise use setDoc
+                if (options.customId) {
+                    // Use setDoc with custom ID
+                    const docRef = doc(firestore, operation.path, options.customId);
+                    batch.set(docRef, { ...data, id: options.customId }, { merge: options.merge });
+                }
+                else {
+                    // Use addDoc to let Firestore generate the ID
+                    // Note: We can't use addDoc in a batch, so we need to generate an ID
+                    const docId = this.generateDocumentId();
+                    const docRef = doc(firestore, operation.path, docId);
+                    batch.set(docRef, { ...data, id: docId }, { merge: options.merge });
+                }
+                break;
+            }
             case 'set': {
                 const docRef = doc(firestore, operation.path);
                 let data = operation.data || {};
@@ -840,6 +765,18 @@ class FirekitDocumentMutations {
                 throw new MutationError(MutationErrorCode.UNIMPLEMENTED, `Operation type ${operation.type} not supported in batch`);
         }
     }
+    /**
+     * Generate a unique document ID (Firestore-style)
+     */
+    generateDocumentId() {
+        // Generate a Firestore-style document ID (20 characters, alphanumeric)
+        const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+        let result = '';
+        for (let i = 0; i < 20; i++) {
+            result += chars.charAt(Math.floor(Math.random() * chars.length));
+        }
+        return result;
+    }
     /**
      * Chunk array into smaller arrays
      */
@@ -974,35 +911,6 @@ class FirekitDocumentMutations {
             (this.analytics.averageDuration * (this.analytics.totalMutations - 1) + duration) /
                 this.analytics.totalMutations;
     }
-    // ========================================
-    // EVENT MANAGEMENT
-    // ========================================
-    /**
-     * 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) {
-        this.eventListeners.add(callback);
-        return () => this.eventListeners.delete(callback);
-    }
-    /**
-     * Remove all event listeners
-     */
-    clearEventListeners() {
-        this.eventListeners.clear();
-    }
     /**
      * Get current mutation analytics
      *
@@ -1069,11 +977,6 @@ 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 const firekitDocMutations = new FirekitDocumentMutations();

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

@@ -3,7 +3,7 @@
  * @module FirekitPresence
  * @version 1.0.0
  */
-import { type PresenceConfig, type Location, type SessionData, type PresenceEventCallback, type PresenceStats, PresenceError } from '../types/presence.js';
+import { type PresenceConfig, type Location, type SessionData, type PresenceStats, PresenceError } from '../types/presence.js';
 /**
  * Main presence tracking service
  *
@@ -18,11 +18,6 @@ import { type PresenceConfig, type Location, type SessionData, type PresenceEven
  *   sessionTTL: 30 * 60 * 1000
  * });
  *
- * // Listen to events
- * const unsubscribe = firekitPresence.addEventListener((event) => {
- *   console.log('Presence event:', event);
- * });
- *
  * // Access reactive state
  * $: console.log('Status:', firekitPresence.status);
  * ```
@@ -32,7 +27,6 @@ declare class FirekitPresence {
     private config;
     private geolocationService;
     private connectedListener;
-    private eventListeners;
     private currentUser;
     private _initialized;
     private _status;
@@ -103,16 +97,6 @@ declare class FirekitPresence {
      * Force refresh presence data
      */
     refresh(): Promise<void>;
-    /**
-     * Add event listener
-     * @param callback Event callback function
-     * @returns Cleanup function to remove listener
-     */
-    addEventListener(callback: PresenceEventCallback): () => void;
-    /**
-     * Emit event to all listeners
-     */
-    private emitEvent;
     /**
      * Dispose of all resources and cleanup
      */
@@ -130,11 +114,6 @@ declare class FirekitPresence {
  *   geolocation: { enabled: true, type: 'browser' },
  *   sessionTTL: 30 * 60 * 1000
  * });
- *
- * // Listen to events
- * const unsubscribe = firekitPresence.addEventListener((event) => {
- *   console.log('Presence event:', event.type, event.data);
- * });
  * ```
  */
 export declare const firekitPresence: FirekitPresence;

package/dist/services/presence.svelte.js

@@ -241,11 +241,6 @@ class DeviceInfoService {
  *   sessionTTL: 30 * 60 * 1000
  * });
  *
- * // Listen to events
- * const unsubscribe = firekitPresence.addEventListener((event) => {
- *   console.log('Presence event:', event);
- * });
- *
  * // Access reactive state
  * $: console.log('Status:', firekitPresence.status);
  * ```
@@ -259,7 +254,6 @@ class FirekitPresence {
     };
     geolocationService = null;
     connectedListener = null;
-    eventListeners = new Set();
     currentUser = null;
     // Reactive state using Svelte 5 runes
     _initialized = $state(false);
@@ -333,12 +327,7 @@ class FirekitPresence {
             if (this.config.geolocation?.enabled) {
                 this.geolocationService = new GeolocationService(this.config.geolocation);
                 if (this.config.geolocation.requireConsent) {
-                    this.emitEvent({ type: 'consent_requested', timestamp: Date.now() });
                     const hasConsent = await this.geolocationService.requestConsent();
-                    this.emitEvent({
-                        type: hasConsent ? 'consent_granted' : 'consent_denied',
-                        timestamp: Date.now()
-                    });
                 }
                 // Start location tracking if consent granted
                 if (!this.config.geolocation.requireConsent || this.geolocationService.hasConsent) {
@@ -348,22 +337,12 @@ class FirekitPresence {
             // Set up Firebase connection monitoring
             await this.setupConnectionMonitoring();
             this._initialized = true;
-            this.emitEvent({
-                type: 'init',
-                data: { userId: user.uid, config: this.config },
-                timestamp: Date.now()
-            });
         }
         catch (error) {
             this._error =
                 error instanceof PresenceError
                     ? error
                     : new PresenceError(PresenceErrorCode.INITIALIZATION_FAILED, `Failed to initialize presence service: ${error.message}`, error);
-            this.emitEvent({
-                type: 'error',
-                error: this._error,
-                timestamp: Date.now()
-            });
             throw this._error;
         }
         finally {
@@ -455,13 +434,6 @@ class FirekitPresence {
                     ...(device && { device }),
                     ...(this.config.customMetadata && { metadata: this.config.customMetadata })
                 };
-                this.emitEvent({
-                    type: 'session_created',
-                    data: { session },
-                    timestamp: Date.now(),
-                    sessionId: session.id,
-                    userId: session.userId
-                });
             }
             else {
                 // Update existing session
@@ -472,13 +444,6 @@ class FirekitPresence {
                     lastActivity: new Date().toISOString(),
                     ...(location && { location })
                 };
-                this.emitEvent({
-                    type: 'session_updated',
-                    data: { session, previousStatus: this._currentSession.status },
-                    timestamp: Date.now(),
-                    sessionId: session.id,
-                    userId: session.userId
-                });
             }
             // Save session to Firebase
             const sessionPath = this.config.sessionPath || 'presence';
@@ -489,34 +454,12 @@ class FirekitPresence {
             this._status = status;
             // Load and update all sessions
             await this.loadSessions();
-            this.emitEvent({
-                type: 'status_change',
-                data: { status, session, location },
-                timestamp: Date.now(),
-                sessionId: session.id,
-                userId: session.userId
-            });
-            // Emit location update if location changed
-            if (location) {
-                this.emitEvent({
-                    type: 'location_update',
-                    data: { location, session },
-                    timestamp: Date.now(),
-                    sessionId: session.id,
-                    userId: session.userId
-                });
-            }
         }
         catch (error) {
             this._error =
                 error instanceof PresenceError
                     ? error
                     : new PresenceError(PresenceErrorCode.DATABASE_ERROR, `Failed to set presence: ${error.message}`, error);
-            this.emitEvent({
-                type: 'error',
-                error: this._error,
-                timestamp: Date.now()
-            });
             throw this._error;
         }
     }
@@ -541,17 +484,10 @@ class FirekitPresence {
                     const cutoffTime = new Date(Date.now() - this.config.sessionTTL).toISOString();
                     const expiredSessions = sessions.filter((session) => session.lastSeen < cutoffTime);
                     sessions = sessions.filter((session) => session.lastSeen >= cutoffTime);
-                    // Remove stale sessions from database and emit events
+                    // Remove stale sessions from database
                     for (const expiredSession of expiredSessions) {
                         const staleSessionRef = ref(db, `${sessionPath}/${this.currentUser.uid}/sessions/${expiredSession.id}`);
                         await set(staleSessionRef, null);
-                        this.emitEvent({
-                            type: 'session_expired',
-                            data: { session: expiredSession },
-                            timestamp: Date.now(),
-                            sessionId: expiredSession.id,
-                            userId: expiredSession.userId
-                        });
                     }
                 }
                 this._sessions = sessions;
@@ -643,31 +579,6 @@ class FirekitPresence {
         }
     }
     // ========================================
-    // EVENT MANAGEMENT
-    // ========================================
-    /**
-     * Add event listener
-     * @param callback Event callback function
-     * @returns Cleanup function to remove listener
-     */
-    addEventListener(callback) {
-        this.eventListeners.add(callback);
-        return () => this.eventListeners.delete(callback);
-    }
-    /**
-     * Emit event to all listeners
-     */
-    emitEvent(event) {
-        this.eventListeners.forEach((callback) => {
-            try {
-                callback(event);
-            }
-            catch (error) {
-                console.error('Error in presence event listener:', error);
-            }
-        });
-    }
-    // ========================================
     // CLEANUP
     // ========================================
     /**
@@ -690,8 +601,6 @@ class FirekitPresence {
             this.connectedListener();
             this.connectedListener = null;
         }
-        // Clear event listeners
-        this.eventListeners.clear();
         // Reset state
         this._initialized = false;
         this._status = 'offline';
@@ -699,10 +608,6 @@ class FirekitPresence {
         this._error = null;
         this._currentSession = null;
         this._sessions = [];
-        this.emitEvent({
-            type: 'disconnect',
-            timestamp: Date.now()
-        });
     }
 }
 /**
@@ -717,11 +622,6 @@ class FirekitPresence {
  *   geolocation: { enabled: true, type: 'browser' },
  *   sessionTTL: 30 * 60 * 1000
  * });
- *
- * // Listen to events
- * const unsubscribe = firekitPresence.addEventListener((event) => {
- *   console.log('Presence event:', event.type, event.data);
- * });
  * ```
  */
 export const firekitPresence = FirekitPresence.getInstance();

package/dist/types/analytics.d.ts

@@ -0,0 +1,84 @@
+/**
+ * @fileoverview Analytics types and interfaces for FirekitAnalytics
+ * @module AnalyticsTypes
+ * @version 1.0.0
+ */
+/**
+ * Analytics event interface
+ */
+export interface AnalyticsEvent {
+    name: string;
+    parameters?: Record<string, any>;
+}
+/**
+ * E-commerce item interface
+ */
+export interface EcommerceItem {
+    item_id: string;
+    item_name: string;
+    item_category?: string;
+    item_variant?: string;
+    item_brand?: string;
+    price?: number;
+    quantity?: number;
+    currency?: string;
+}
+/**
+ * Purchase event interface
+ */
+export interface PurchaseEvent {
+    transaction_id: string;
+    value: number;
+    currency?: string;
+    tax?: number;
+    shipping?: number;
+    items?: EcommerceItem[];
+}
+/**
+ * Form submission event interface
+ */
+export interface FormSubmissionEvent {
+    form_name: string;
+    form_id?: string;
+    success?: boolean;
+    error_message?: string;
+}
+/**
+ * Search event interface
+ */
+export interface SearchEvent {
+    search_term: string;
+    results_count?: number;
+    category?: string;
+}
+/**
+ * Page view event interface
+ */
+export interface PageViewEvent {
+    page_path: string;
+    page_title?: string;
+    page_location?: string;
+    page_referrer?: string;
+}
+/**
+ * User engagement event interface
+ */
+export interface EngagementEvent {
+    engagement_time_msec?: number;
+    session_id?: string;
+}
+/**
+ * Analytics configuration interface
+ */
+export interface AnalyticsConfig {
+    /** Enable debug mode for analytics */
+    debugMode?: boolean;
+    /** Enable automatic page tracking */
+    enablePageTracking?: boolean;
+    /** Enable automatic user tracking */
+    enableUserTracking?: boolean;
+    /** Custom parameters to include in all events */
+    customParameters?: Record<string, any>;
+    /** Enable analytics collection */
+    enabled?: boolean;
+}

package/dist/types/analytics.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Analytics types and interfaces for FirekitAnalytics
+ * @module AnalyticsTypes
+ * @version 1.0.0
+ */
+export {};