svelte-firekit 0.0.25 → 0.1.1

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

@@ -0,0 +1,141 @@
+/**
+ * @fileoverview FirekitPresence - Clean presence tracking for Svelte applications
+ * @module FirekitPresence
+ * @version 1.0.0
+ */
+import { type PresenceConfig, type Location, type SessionData, type PresenceEventCallback, type PresenceStats, PresenceError } from '../types/presence.js';
+/**
+ * Main presence tracking service
+ *
+ * @class FirekitPresence
+ * @example
+ * ```typescript
+ * import { firekitPresence } from 'svelte-firekit';
+ *
+ * // Initialize
+ * await firekitPresence.initialize(user, {
+ *   geolocation: { enabled: true, type: 'browser' },
+ *   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);
+ * ```
+ */
+declare class FirekitPresence {
+    private static instance;
+    private config;
+    private geolocationService;
+    private connectedListener;
+    private eventListeners;
+    private currentUser;
+    private _initialized;
+    private _status;
+    private _loading;
+    private _error;
+    private _currentSession;
+    private _sessions;
+    private constructor();
+    /**
+     * Gets singleton instance of FirekitPresence
+     */
+    static getInstance(): FirekitPresence;
+    get initialized(): boolean;
+    get status(): SessionData['status'];
+    get loading(): boolean;
+    get error(): PresenceError | null;
+    get currentSession(): SessionData | null;
+    get sessions(): SessionData[];
+    get location(): Location | null;
+    get hasLocationConsent(): boolean;
+    /**
+     * Initialize presence tracking
+     * @param user Current authenticated user
+     * @param config Presence configuration options
+     */
+    initialize(user: any, config?: PresenceConfig): Promise<void>;
+    /**
+     * Set up Firebase connection monitoring
+     */
+    private setupConnectionMonitoring;
+    /**
+     * Set up disconnect handler for graceful offline transitions
+     */
+    private setupDisconnectHandler;
+    /**
+     * Set up page visibility listener
+     */
+    private setupVisibilityListener;
+    /**
+     * Set presence status
+     */
+    setPresence(status: SessionData['status']): Promise<void>;
+    /**
+     * Load all sessions for current user
+     */
+    private loadSessions;
+    /**
+     * Get presence statistics
+     */
+    getPresenceStats(): PresenceStats;
+    /**
+     * Request location consent manually
+     */
+    requestLocationConsent(): Promise<boolean>;
+    /**
+     * Get current user's online sessions count
+     */
+    getOnlineSessionsCount(): number;
+    /**
+     * Check if user is online on any device
+     */
+    isUserOnline(): boolean;
+    /**
+     * Get sessions by status
+     */
+    getSessionsByStatus(status: SessionData['status']): SessionData[];
+    /**
+     * 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
+     */
+    dispose(): Promise<void>;
+}
+/**
+ * Pre-initialized singleton instance of FirekitPresence.
+ *
+ * @example
+ * ```typescript
+ * import { firekitPresence } from 'svelte-firekit';
+ *
+ * // Initialize presence tracking
+ * await firekitPresence.initialize(user, {
+ *   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;
+export {};