svelte-firekit 0.0.25 → 0.1.1

package/package.json

@@ -1,65 +1,65 @@
-{
-	"name": "svelte-firekit",
-	"version": "0.0.25",
-	"license": "MIT",
-	"scripts": {
-		"dev": "vite dev",
-		"build": "vite build && npm run package",
-		"preview": "vite preview",
-		"package": "svelte-kit sync && svelte-package && publint",
-		"prepublishOnly": "npm run package",
-		"check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
-		"check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
-		"format": "prettier --write .",
-		"lint": "prettier --check ."
-	},
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/code-gio/svelte-firekit.git"
-	},
-	"description": "A Svelte library for Firebase integration",
-	"keywords": [
-		"svelte",
-		"firebase",
-		"library",
-		"frontend"
-	],
-	"author": "Giovani Rodriguez",
-	"files": [
-		"dist",
-		"!dist/**/*.test.*",
-		"!dist/**/*.spec.*"
-	],
-	"sideEffects": [
-		"**/*.css"
-	],
-	"svelte": "./dist/index.js",
-	"types": "./dist/index.d.ts",
-	"type": "module",
-	"exports": {
-		".": {
-			"types": "./dist/index.d.ts",
-			"svelte": "./dist/index.js"
-		}
-	},
-	"peerDependencies": {
-		"firebase": "^11.0.1",
-		"svelte": "^5.0.0"
-	},
-	"devDependencies": {
-		"@sveltejs/adapter-auto": "^3.0.0",
-		"@sveltejs/kit": "^2.9.0",
-		"@sveltejs/package": "^2.0.0",
-		"@sveltejs/vite-plugin-svelte": "^5.0.0",
-		"prettier": "^3.3.2",
-		"prettier-plugin-svelte": "^3.2.6",
-		"publint": "^0.2.0",
-		"svelte": "^5.0.0",
-		"svelte-check": "^4.0.0",
-		"typescript": "^5.0.0",
-		"vite": "^6.0.0"
-	},
-	"dependencies": {
-		"firebase": "^11.0.2"
-	}
+{
+	"name": "svelte-firekit",
+	"version": "0.1.1",
+	"license": "MIT",
+	"scripts": {
+		"dev": "vite dev",
+		"build": "vite build && npm run prepack",
+		"preview": "vite preview",
+		"prepare": "svelte-kit sync || echo ''",
+		"prepack": "svelte-kit sync && svelte-package && publint",
+		"check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
+		"check:watch": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json --watch",
+		"format": "prettier --write .",
+		"lint": "prettier --check ."
+	},
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/code-gio/svelte-firekit.git"
+	},
+	"description": "A Svelte library for Firebase integration",
+	"keywords": [
+		"svelte",
+		"firebase",
+		"library",
+		"frontend"
+	],
+	"author": "Giovani Rodriguez",
+	"files": [
+		"dist",
+		"!dist/**/*.test.*",
+		"!dist/**/*.spec.*"
+	],
+	"sideEffects": [
+		"**/*.css"
+	],
+	"svelte": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"type": "module",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"svelte": "./dist/index.js"
+		}
+	},
+	"peerDependencies": {
+		"firebase": "^11.9.1",
+		"svelte": "^5.0.0"
+	},
+	"devDependencies": {
+		"@sveltejs/adapter-auto": "^6.0.0",
+		"@sveltejs/kit": "^2.16.0",
+		"@sveltejs/package": "^2.0.0",
+		"@sveltejs/vite-plugin-svelte": "^5.0.0",
+		"prettier": "^3.4.2",
+		"prettier-plugin-svelte": "^3.3.3",
+		"publint": "^0.3.2",
+		"svelte": "^5.0.0",
+		"svelte-check": "^4.0.0",
+		"typescript": "^5.0.0",
+		"vite": "^6.2.6"
+	},
+	"dependencies": {
+		"firebase": "^11.9.1"
+	}
 }

package/dist/auth/auth.d.ts

@@ -1,117 +0,0 @@
-/**
- * @module FirekitAuth
- */
-/**
- * Manages Firebase authentication operations including sign-in, registration, and profile management.
- * @class
- * @example
- * ```typescript
- * // Sign in with Google
- * await firekitAuth.signInWithGoogle();
- *
- * // Register new user
- * await firekitAuth.registerWithEmail("user@example.com", "password123", "John Doe");
- * ```
- */
-declare class FirekitAuth {
-    private static instance;
-    private auth;
-    private firestore;
-    private constructor();
-    /**
-     * Gets singleton instance of FirekitAuth
-     * @returns {FirekitAuth} The FirekitAuth instance
-     */
-    static getInstance(): FirekitAuth;
-    /**
-     * Initiates Google sign-in popup and updates user data in Firestore
-     * @throws {Error} If sign-in fails
-     */
-    signInWithGoogle(): Promise<void>;
-    /**
-     * Signs in user with email and password
-     * @param {string} email User's email
-     * @param {string} password User's password
-     * @throws {Error} If sign-in fails
-     */
-    signInWithEmail(email: string, password: string): Promise<void>;
-    /**
-     * Registers new user with email and password
-     * @param {string} email User's email
-     * @param {string} password User's password
-     * @param {string} displayName User's display name
-     * @throws {Error} If registration fails
-     */
-    registerWithEmail(email: string, password: string, displayName: string): Promise<void>;
-    /**
-     * Updates user data in Firestore
-     * @param {User} user Firebase user object
-     * @private
-     */
-    private updateUserInFirestore;
-    /**
-     * Signs out current user
-     * @throws {Error} If sign-out fails
-     */
-    logOut(): Promise<void>;
-    /**
-     * Sends password reset email
-     * @param {string} email User's email
-     * @throws {Error} If sending reset email fails
-     */
-    sendPasswordReset(email: string): Promise<void>;
-    /**
-     * Sends email verification to current user
-     * @throws {Error} If sending verification fails
-     */
-    sendEmailVerificationToUser(): Promise<void>;
-    /**
-     * Updates user profile data
-     * @param {Object} profile Profile update data
-     * @param {string} [profile.displayName] New display name
-     * @param {string} [profile.photoURL] New photo URL
-     * @throws {Error} If update fails
-     */
-    updateUserProfile(profile: {
-        displayName?: string;
-        photoURL?: string;
-    }): Promise<void>;
-    /**
-     * Updates user password with reauthentication
-     * @param {string} newPassword New password
-     * @param {string} currentPassword Current password for reauthentication
-     * @returns {Promise<{success: boolean, message: string, code?: string}>} Update result
-     */
-    updateUserPassword(newPassword: string, currentPassword: string): Promise<{
-        success: boolean;
-        message: string;
-        code?: undefined;
-    } | {
-        success: boolean;
-        code: any;
-        message: string;
-    }>;
-    /**
-     * Reauthenticates current user
-     * @param {string} currentPassword Current password
-     * @throws {Error} If reauthentication fails
-     * @private
-     */
-    private reauthenticateUser;
-    /**
-     * Deletes user account and associated data
-     * @returns {Promise<{success: boolean, message: string}>} Deletion result
-     * @throws {Error} If deletion fails
-     */
-    deleteUserAccount(): Promise<{
-        success: boolean;
-        message: string;
-    }>;
-}
-/**
- * Pre-initialized singleton instance of FirekitAuth
- * @const
- * @type {FirekitAuth}
- */
-export declare const firekitAuth: FirekitAuth;
-export {};

package/dist/auth/auth.js

@@ -1,194 +0,0 @@
-/**
- * @module FirekitAuth
- */
-import { GoogleAuthProvider, sendPasswordResetEmail, signInWithEmailAndPassword, signInWithPopup, signOut, createUserWithEmailAndPassword, sendEmailVerification, updateProfile, updatePassword, EmailAuthProvider, reauthenticateWithCredential, } from 'firebase/auth';
-import { doc, setDoc } from 'firebase/firestore';
-import { firebaseService } from '../firebase.js';
-import { firekitDocMutations } from '../firestore/document-mutations.svelte.js';
-/**
- * Manages Firebase authentication operations including sign-in, registration, and profile management.
- * @class
- * @example
- * ```typescript
- * // Sign in with Google
- * await firekitAuth.signInWithGoogle();
- *
- * // Register new user
- * await firekitAuth.registerWithEmail("user@example.com", "password123", "John Doe");
- * ```
- */
-class FirekitAuth {
-    static instance;
-    auth = firebaseService.getAuthInstance();
-    firestore = firebaseService.getDbInstance();
-    constructor() { }
-    /**
-     * Gets singleton instance of FirekitAuth
-     * @returns {FirekitAuth} The FirekitAuth instance
-     */
-    static getInstance() {
-        if (!FirekitAuth.instance) {
-            FirekitAuth.instance = new FirekitAuth();
-        }
-        return FirekitAuth.instance;
-    }
-    /**
-     * Initiates Google sign-in popup and updates user data in Firestore
-     * @throws {Error} If sign-in fails
-     */
-    async signInWithGoogle() {
-        const provider = new GoogleAuthProvider();
-        const result = await signInWithPopup(this.auth, provider);
-        await this.updateUserInFirestore(result.user);
-    }
-    /**
-     * Signs in user with email and password
-     * @param {string} email User's email
-     * @param {string} password User's password
-     * @throws {Error} If sign-in fails
-     */
-    async signInWithEmail(email, password) {
-        const result = await signInWithEmailAndPassword(this.auth, email, password);
-        await this.updateUserInFirestore(result.user);
-    }
-    /**
-     * Registers new user with email and password
-     * @param {string} email User's email
-     * @param {string} password User's password
-     * @param {string} displayName User's display name
-     * @throws {Error} If registration fails
-     */
-    async registerWithEmail(email, password, displayName) {
-        const result = await createUserWithEmailAndPassword(this.auth, email, password);
-        const user = result.user;
-        if (user) {
-            await updateProfile(user, { displayName });
-            await this.updateUserInFirestore(user);
-            await sendEmailVerification(user);
-        }
-    }
-    /**
-     * Updates user data in Firestore
-     * @param {User} user Firebase user object
-     * @private
-     */
-    async updateUserInFirestore(user) {
-        const ref = doc(this.firestore, 'users', user.uid);
-        const userData = {
-            uid: user.uid,
-            email: user.email,
-            emailVerified: user.emailVerified,
-            displayName: user.displayName,
-            photoURL: user.photoURL,
-            isAnonymous: user.isAnonymous,
-            providerId: user.providerId,
-            providerData: user.providerData,
-        };
-        await setDoc(ref, userData, { merge: true });
-    }
-    /**
-     * Signs out current user
-     * @throws {Error} If sign-out fails
-     */
-    async logOut() {
-        await signOut(this.auth);
-    }
-    /**
-     * Sends password reset email
-     * @param {string} email User's email
-     * @throws {Error} If sending reset email fails
-     */
-    async sendPasswordReset(email) {
-        await sendPasswordResetEmail(this.auth, email);
-    }
-    /**
-     * Sends email verification to current user
-     * @throws {Error} If sending verification fails
-     */
-    async sendEmailVerificationToUser() {
-        if (this.auth.currentUser) {
-            await sendEmailVerification(this.auth.currentUser);
-        }
-    }
-    /**
-     * Updates user profile data
-     * @param {Object} profile Profile update data
-     * @param {string} [profile.displayName] New display name
-     * @param {string} [profile.photoURL] New photo URL
-     * @throws {Error} If update fails
-     */
-    async updateUserProfile(profile) {
-        if (this.auth.currentUser) {
-            await updateProfile(this.auth.currentUser, profile);
-            await this.updateUserInFirestore(this.auth.currentUser);
-        }
-    }
-    /**
-     * Updates user password with reauthentication
-     * @param {string} newPassword New password
-     * @param {string} currentPassword Current password for reauthentication
-     * @returns {Promise<{success: boolean, message: string, code?: string}>} Update result
-     */
-    async updateUserPassword(newPassword, currentPassword) {
-        if (!this.auth.currentUser) {
-            throw new Error('No authenticated user found.');
-        }
-        try {
-            await this.reauthenticateUser(currentPassword);
-            await updatePassword(this.auth.currentUser, newPassword);
-            return { success: true, message: 'Password successfully updated.' };
-        }
-        catch (error) {
-            if (error.code === 'auth/wrong-password') {
-                return { success: false, code: error.code, message: 'Reauthentication failed: incorrect password.' };
-            }
-            return {
-                success: false,
-                code: error.code || 'unknown_error',
-                message: `Failed to update password: ${error.message || 'Unknown error occurred.'}`
-            };
-        }
-    }
-    /**
-     * Reauthenticates current user
-     * @param {string} currentPassword Current password
-     * @throws {Error} If reauthentication fails
-     * @private
-     */
-    async reauthenticateUser(currentPassword) {
-        if (!this.auth.currentUser || !this.auth.currentUser.email) {
-            throw new Error('No authenticated user or email unavailable.');
-        }
-        const credential = EmailAuthProvider.credential(this.auth.currentUser.email, currentPassword);
-        try {
-            await reauthenticateWithCredential(this.auth.currentUser, credential);
-        }
-        catch (error) {
-            throw new Error(`Reauthentication failed: ${error.message || 'Unknown error occurred.'}`);
-        }
-    }
-    /**
-     * Deletes user account and associated data
-     * @returns {Promise<{success: boolean, message: string}>} Deletion result
-     * @throws {Error} If deletion fails
-     */
-    async deleteUserAccount() {
-        if (!this.auth.currentUser) {
-            throw new Error('No authenticated user found.');
-        }
-        try {
-            firekitDocMutations.delete(`users/${this.auth.currentUser.uid}`);
-            await this.auth.currentUser.delete();
-            return { success: true, message: 'Account successfully deleted.' };
-        }
-        catch (error) {
-            throw new Error(error.message);
-        }
-    }
-}
-/**
- * Pre-initialized singleton instance of FirekitAuth
- * @const
- * @type {FirekitAuth}
- */
-export const firekitAuth = FirekitAuth.getInstance();

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

@@ -1,139 +0,0 @@
-/**
- * Geolocation configuration options
- */
-interface GeolocationConfig {
-    /** Whether geolocation tracking is enabled */
-    enabled: boolean;
-    /** Type of geolocation service to use */
-    type: 'browser' | 'ip' | 'custom';
-    /** Custom function for retrieving geolocation */
-    customGeolocationFn?: () => Promise<{
-        latitude: number;
-        longitude: number;
-    }>;
-    /** URL for IP-based geolocation service */
-    ipServiceUrl?: string;
-    /** Whether user consent is required for location tracking */
-    requireConsent?: boolean;
-}
-/**
- * Presence service configuration options
- */
-interface PresenceConfig {
-    /** Geolocation settings */
-    geolocation?: GeolocationConfig;
-    /** Session timeout in milliseconds */
-    sessionTTL?: number;
-    /** Presence update interval in milliseconds */
-    updateInterval?: number;
-}
-/**
- * Location data structure
- */
-interface Location {
-    latitude: number | null;
-    longitude: number | null;
-    lastUpdated: string | null;
-}
-/**
- * Session data structure
- */
-interface SessionData {
-    uid: string;
-    userId: string;
-    deviceId: string;
-    status: 'online' | 'offline' | 'away';
-    createdAt: string;
-    lastSeen: string;
-    location?: Location;
-}
-/**
- * Presence event structure
- */
-type PresenceEvent = {
-    type: 'status_change' | 'error' | 'init' | 'disconnect' | 'location_update';
-    data?: any;
-    error?: Error;
-    timestamp: number;
-};
-type PresenceEventCallback = (event: PresenceEvent) => void;
-/**
- * Manages real-time user presence tracking with optional geolocation support
- * @class
- * @example
- * ```typescript
- * // Initialize presence tracking
- * await presenceService.initialize(currentUser, {
- *   geolocation: { enabled: true, type: 'browser' },
- *   sessionTTL: 30 * 60 * 1000
- * });
- *
- * // Listen for presence events
- * presenceService.addEventListener((event) => {
- *   console.log(event.type, event.data);
- * });
- * ```
- */
-declare class PresenceService {
-    private static instance;
-    private connectedListener;
-    private locationWatcher;
-    private currentUser;
-    private eventListeners;
-    private config;
-    private initialized;
-    private locationConsent;
-    private _currentSession;
-    private _sessions;
-    private _status;
-    private _loading;
-    private _error;
-    private constructor();
-    static getInstance(): PresenceService;
-    /** Get current session data */
-    get currentSession(): SessionData | null;
-    /** Get all active sessions */
-    get sessions(): SessionData[];
-    /** Get current presence status */
-    get status(): "online" | "offline" | "away";
-    /** Get loading state */
-    get loading(): boolean;
-    /** Get error state */
-    get error(): Error | null;
-    /** Check if service is initialized */
-    get isInitialized(): boolean;
-    /** Check if location consent is granted */
-    get hasLocationConsent(): boolean;
-    /**
- * Initialize presence tracking
- * @param {any} user Current user object
- * @param {PresenceConfig} config Optional configuration
- * @throws {Error} If initialization fails
- */
-    private initializePresence;
-    private setupVisibilityListener;
-    private getDeviceInfo;
-    /**
-    * Request location tracking consent
-    * @returns {Promise<boolean>} Whether consent was granted
-    */
-    requestLocationConsent(): Promise<boolean>;
-    private getLocation;
-    initialize(user: any, config?: PresenceConfig): Promise<void>;
-    private setPresence;
-    private startLocationWatcher;
-    private stopLocationWatcher;
-    /**
-      * Add presence event listener
-      * @param {Function} callback Event callback function
-      * @returns {Function} Cleanup function to remove listener
-      */
-    addEventListener(callback: PresenceEventCallback): () => boolean;
-    private emitEvent;
-    /**
-         * Cleanup presence tracking
-         */
-    dispose(): void;
-}
-export declare const presenceService: PresenceService;
-export {};