svelte-firekit 0.1.9 → 0.2.0

package/dist/types/presence.d.ts

@@ -1,54 +1,25 @@
-/**
- * @fileoverview Presence types and interfaces for FirekitPresence
- * @module PresenceTypes
- * @version 1.0.0
- */
-/**
- * Geolocation configuration options
- */
 export 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;
-    /** High accuracy GPS tracking */
     enableHighAccuracy?: boolean;
-    /** Location timeout in milliseconds */
     timeout?: number;
-    /** Maximum age of cached location in milliseconds */
     maximumAge?: number;
 }
-/**
- * Presence service configuration options
- */
 export interface PresenceConfig {
-    /** Geolocation settings */
     geolocation?: GeolocationConfig;
-    /** Session timeout in milliseconds (default: 30 minutes) */
     sessionTTL?: number;
-    /** Presence update interval in milliseconds (default: 1 minute) */
     updateInterval?: number;
-    /** Custom user metadata to track */
-    customMetadata?: Record<string, any>;
-    /** Whether to track device information */
+    customMetadata?: Record<string, unknown>;
     trackDeviceInfo?: boolean;
-    /** Custom session collection path in Firebase */
     sessionPath?: string;
-    /** Whether to enable automatic status detection based on page visibility */
     enableAutoStatusDetection?: boolean;
 }
-/**
- * Location data structure
- */
 export interface Location {
     latitude: number;
     longitude: number;
@@ -60,9 +31,6 @@ export interface Location {
     lastUpdated: string;
     source: 'browser' | 'ip' | 'custom';
 }
-/**
- * Device information structure
- */
 export interface DeviceInfo {
     id: string;
     type: 'desktop' | 'mobile' | 'tablet' | 'unknown';
@@ -74,9 +42,6 @@ export interface DeviceInfo {
     screenResolution?: string;
     timezone?: string;
 }
-/**
- * Session data structure
- */
 export interface SessionData {
     id: string;
     userId: string;
@@ -85,13 +50,10 @@ export interface SessionData {
     lastSeen: string;
     location?: Location;
     device?: DeviceInfo;
-    metadata?: Record<string, any>;
+    metadata?: Record<string, unknown>;
     connectionType?: 'wifi' | 'cellular' | 'ethernet' | 'unknown';
     lastActivity?: string;
 }
-/**
- * User presence summary
- */
 export interface UserPresence {
     userId: string;
     status: SessionData['status'];
@@ -101,9 +63,6 @@ export interface UserPresence {
     primarySession?: SessionData;
     location?: Location;
 }
-/**
- * Presence statistics
- */
 export interface PresenceStats {
     totalSessions: number;
     onlineSessions: number;
@@ -113,120 +72,20 @@ export interface PresenceStats {
     averageSessionDuration: number;
     lastActivity: string;
 }
-/**
- * Geolocation provider interface
- */
 export interface GeolocationProvider {
     getCurrentLocation(): Promise<Location | null>;
     watchPosition?(callback: (location: Location | null) => void): number;
     clearWatch?(watchId: number): void;
     requestPermission?(): Promise<boolean>;
 }
-/**
- * Session storage interface
- */
-export interface SessionStorage {
-    saveSession(userId: string, session: SessionData): Promise<void>;
-    loadSessions(userId: string): Promise<SessionData[]>;
-    deleteSession(userId: string, sessionId: string): Promise<void>;
-    cleanupExpiredSessions(userId: string, ttl: number): Promise<void>;
-}
-/**
- * Presence service interface
- */
 export interface PresenceService {
-    initialize(user: any, config?: PresenceConfig): Promise<void>;
+    initialize(user: unknown, config?: PresenceConfig): Promise<void>;
     setPresence(status: SessionData['status']): Promise<void>;
     getCurrentSession(): SessionData | null;
     getAllSessions(): SessionData[];
     getPresenceStats(): PresenceStats;
     dispose(): Promise<void>;
 }
-/**
- * Connection info structure
- */
-export interface ConnectionInfo {
-    effectiveType?: 'slow-2g' | '2g' | '3g' | '4g';
-    type?: 'bluetooth' | 'cellular' | 'ethernet' | 'none' | 'wifi' | 'wimax' | 'other' | 'unknown';
-    downlink?: number;
-    rtt?: number;
-    saveData?: boolean;
-}
-/**
- * Browser capability detection
- */
-export interface BrowserCapabilities {
-    geolocation: boolean;
-    notifications: boolean;
-    serviceWorker: boolean;
-    indexedDB: boolean;
-    webRTC: boolean;
-    websockets: boolean;
-    localStorage: boolean;
-}
-/**
- * Presence filter options
- */
-export interface PresenceFilter {
-    status?: SessionData['status'][];
-    deviceTypes?: DeviceInfo['type'][];
-    timeRange?: {
-        start: string;
-        end: string;
-    };
-    hasLocation?: boolean;
-    activeOnly?: boolean;
-}
-/**
- * Bulk presence update
- */
-export interface BulkPresenceUpdate {
-    userId: string;
-    updates: Partial<SessionData>[];
-    timestamp: string;
-}
-/**
- * Presence query options
- */
-export interface PresenceQueryOptions {
-    limit?: number;
-    orderBy?: 'lastSeen' | 'createdAt' | 'status';
-    direction?: 'asc' | 'desc';
-    filter?: PresenceFilter;
-    includeExpired?: boolean;
-}
-/**
- * Custom presence status
- */
-export interface CustomPresenceStatus {
-    key: string;
-    label: string;
-    color?: string;
-    icon?: string;
-    priority?: number;
-    autoDetect?: boolean;
-}
-/**
- * Presence analytics data
- */
-export interface PresenceAnalytics {
-    userId: string;
-    dailyActiveTime: number;
-    weeklyActiveTime: number;
-    monthlyActiveTime: number;
-    mostActiveDevice: string;
-    mostActiveHour: number;
-    averageSessionLength: number;
-    locationHistory: Location[];
-    statusHistory: Array<{
-        status: SessionData['status'];
-        timestamp: string;
-        duration: number;
-    }>;
-}
-/**
- * Error types for presence service
- */
 export declare enum PresenceErrorCode {
     INITIALIZATION_FAILED = "presence/initialization-failed",
     USER_NOT_AUTHENTICATED = "presence/user-not-authenticated",
@@ -240,23 +99,11 @@ export declare enum PresenceErrorCode {
     NETWORK_ERROR = "presence/network-error",
     PERMISSION_DENIED = "presence/permission-denied"
 }
-/**
- * Custom presence error class
- */
 export declare class PresenceError extends Error {
     code: PresenceErrorCode;
-    originalError?: any | undefined;
-    constructor(code: PresenceErrorCode, message: string, originalError?: any | undefined);
-    /**
-     * Get user-friendly error message
-     */
+    originalError?: unknown | undefined;
+    constructor(code: PresenceErrorCode, message: string, originalError?: unknown | undefined);
     getFriendlyMessage(): string;
-    /**
-     * Check if error is retryable
-     */
     isRetryable(): boolean;
-    /**
-     * Check if error requires user action
-     */
     requiresUserAction(): boolean;
 }

package/dist/types/presence.js

@@ -1,11 +1,3 @@
-/**
- * @fileoverview Presence types and interfaces for FirekitPresence
- * @module PresenceTypes
- * @version 1.0.0
- */
-/**
- * Error types for presence service
- */
 export var PresenceErrorCode;
 (function (PresenceErrorCode) {
     PresenceErrorCode["INITIALIZATION_FAILED"] = "presence/initialization-failed";
@@ -20,9 +12,6 @@ export var PresenceErrorCode;
     PresenceErrorCode["NETWORK_ERROR"] = "presence/network-error";
     PresenceErrorCode["PERMISSION_DENIED"] = "presence/permission-denied";
 })(PresenceErrorCode || (PresenceErrorCode = {}));
-/**
- * Custom presence error class
- */
 export class PresenceError extends Error {
     code;
     originalError;
@@ -32,9 +21,6 @@ export class PresenceError extends Error {
         this.originalError = originalError;
         this.name = 'PresenceError';
     }
-    /**
-     * Get user-friendly error message
-     */
     getFriendlyMessage() {
         switch (this.code) {
             case PresenceErrorCode.GEOLOCATION_DENIED:
@@ -55,9 +41,6 @@ export class PresenceError extends Error {
                 return this.message || 'An unknown error occurred.';
         }
     }
-    /**
-     * Check if error is retryable
-     */
     isRetryable() {
         const retryableCodes = [
             PresenceErrorCode.NETWORK_ERROR,
@@ -66,9 +49,6 @@ export class PresenceError extends Error {
         ];
         return retryableCodes.includes(this.code);
     }
-    /**
-     * Check if error requires user action
-     */
     requiresUserAction() {
         const userActionCodes = [
             PresenceErrorCode.GEOLOCATION_DENIED,

package/dist/utils/errors.d.ts

@@ -1,21 +1,17 @@
 import { FirekitAuthError } from '../types/auth.js';
 /**
- * Creates a standardized FirekitAuthError with context
- * @param {any} error Original error object
- * @param {string} context Context of the operation that failed
- * @returns {FirekitAuthError} Standardized error object
+ * Creates a standardized FirekitAuthError from a raw Firebase error.
  */
-export declare function createAuthError(error: any, context: string): FirekitAuthError;
+export declare function createAuthError(error: unknown, context: string): FirekitAuthError;
 /**
- * Validates that a current user exists and returns the user
- * @param {any} auth Firebase auth instance
- * @returns {any} Current Firebase user
- * @throws {FirekitAuthError} If no authenticated user found
+ * Validates that a current user exists and returns it.
+ * @throws {FirekitAuthError} If no authenticated user found.
  */
-export declare function validateCurrentUser(auth: any): any;
+export declare function validateCurrentUser(auth: {
+    currentUser: unknown;
+}): NonNullable<unknown>;
 /**
- * Handles Firebase authentication errors and throws FirekitAuthError with friendly message
- * @param {any} error Original Firebase error
- * @returns {never} Never returns, always throws
+ * Converts any Firebase auth error into a FirekitAuthError with a friendly message.
+ * @throws {FirekitAuthError} Always throws.
  */
-export declare function handleAuthError(error: any): never;
+export declare function handleAuthError(error: unknown): never;

package/dist/utils/errors.js

@@ -1,19 +1,15 @@
 import { FirekitAuthError, AuthErrorCode } from '../types/auth.js';
 /**
- * Creates a standardized FirekitAuthError with context
- * @param {any} error Original error object
- * @param {string} context Context of the operation that failed
- * @returns {FirekitAuthError} Standardized error object
+ * Creates a standardized FirekitAuthError from a raw Firebase error.
  */
 export function createAuthError(error, context) {
-    const code = error.code;
-    return new FirekitAuthError(code || `${context}-failed`, `Failed to ${context}: ${error.message}`);
+    const firebaseError = error;
+    const code = firebaseError.code || `${context}-failed`;
+    return new FirekitAuthError(code, `Failed to ${context}: ${firebaseError.message ?? 'unknown error'}`);
 }
 /**
- * Validates that a current user exists and returns the user
- * @param {any} auth Firebase auth instance
- * @returns {any} Current Firebase user
- * @throws {FirekitAuthError} If no authenticated user found
+ * Validates that a current user exists and returns it.
+ * @throws {FirekitAuthError} If no authenticated user found.
  */
 export function validateCurrentUser(auth) {
     const user = auth.currentUser;
@@ -23,13 +19,12 @@ export function validateCurrentUser(auth) {
     return user;
 }
 /**
- * Handles Firebase authentication errors and throws FirekitAuthError with friendly message
- * @param {any} error Original Firebase error
- * @returns {never} Never returns, always throws
+ * Converts any Firebase auth error into a FirekitAuthError with a friendly message.
+ * @throws {FirekitAuthError} Always throws.
  */
 export function handleAuthError(error) {
-    const code = error.code;
-    const firekitError = new FirekitAuthError(code, error.message, error);
-    // Use the existing getFriendlyMessage method from FirekitAuthError
+    const firebaseError = error;
+    const code = firebaseError.code || AuthErrorCode.INTERNAL_ERROR;
+    const firekitError = new FirekitAuthError(code, firebaseError.message ?? 'Unknown error', error);
     throw new FirekitAuthError(code, firekitError.getFriendlyMessage(), error);
 }

package/dist/utils/firestore.d.ts

@@ -1,9 +1,8 @@
 import type { Firestore } from 'firebase/firestore';
 import type { User } from 'firebase/auth';
 /**
- * Updates user data in Firestore with comprehensive profile information
- * @param {Firestore} firestore Firestore instance
- * @param {User} user Firebase user object
- * @returns {Promise<void>} Promise that resolves when update completes
+ * Upserts user profile data into the `users/{uid}` Firestore document.
+ * Uses merge so existing fields not present in User are preserved.
+ * Silently swallows errors so auth operations are never blocked by Firestore failures.
  */
 export declare function updateUserInFirestore(firestore: Firestore, user: User): Promise<void>;

package/dist/utils/firestore.js

@@ -1,14 +1,13 @@
 import { doc, setDoc, serverTimestamp } from 'firebase/firestore';
 /**
- * Updates user data in Firestore with comprehensive profile information
- * @param {Firestore} firestore Firestore instance
- * @param {User} user Firebase user object
- * @returns {Promise<void>} Promise that resolves when update completes
+ * Upserts user profile data into the `users/{uid}` Firestore document.
+ * Uses merge so existing fields not present in User are preserved.
+ * Silently swallows errors so auth operations are never blocked by Firestore failures.
  */
 export async function updateUserInFirestore(firestore, user) {
     try {
         const userRef = doc(firestore, 'users', user.uid);
-        const userData = {
+        await setDoc(userRef, {
             uid: user.uid,
             email: user.email,
             emailVerified: user.emailVerified,
@@ -23,11 +22,9 @@ export async function updateUserInFirestore(firestore, user) {
                 lastSignInTime: user.metadata.lastSignInTime
             },
             lastUpdated: serverTimestamp()
-        };
-        await setDoc(userRef, userData, { merge: true });
+        }, { merge: true });
     }
-    catch (error) {
-        console.error('Failed to update user in Firestore:', error);
-        // Don't throw here to avoid blocking auth operations
+    catch {
+        // Intentionally silent — never block auth flows due to a Firestore write failure
     }
 }

package/dist/utils/index.d.ts

@@ -1,4 +1,4 @@
-export { mapFirebaseUserToProfile } from './user.js';
-export { updateUserInFirestore } from './firestore.js';
-export { createAuthError, validateCurrentUser, handleAuthError } from './errors.js';
-export { createGoogleProvider, createFacebookProvider, createAppleProvider } from './providers.js';
+export * from './errors.js';
+export * from './providers.js';
+export * from './user.js';
+export * from './firestore.js';

package/dist/utils/index.js

@@ -1,8 +1,4 @@
-// User utilities
-export { mapFirebaseUserToProfile } from './user.js';
-// Firestore utilities
-export { updateUserInFirestore } from './firestore.js';
-// Error handling utilities
-export { createAuthError, validateCurrentUser, handleAuthError } from './errors.js';
-// Provider utilities
-export { createGoogleProvider, createFacebookProvider, createAppleProvider } from './providers.js';
+export * from './errors.js';
+export * from './providers.js';
+export * from './user.js';
+export * from './firestore.js';

package/dist/utils/providers.d.ts

@@ -1,16 +1,7 @@
-import { GoogleAuthProvider, FacebookAuthProvider, OAuthProvider } from 'firebase/auth';
-/**
- * Creates a configured Google Auth provider
- * @returns {GoogleAuthProvider} Configured Google provider
- */
+import { GoogleAuthProvider, FacebookAuthProvider, OAuthProvider, GithubAuthProvider, TwitterAuthProvider } from 'firebase/auth';
 export declare function createGoogleProvider(): GoogleAuthProvider;
-/**
- * Creates a configured Facebook Auth provider
- * @returns {FacebookAuthProvider} Configured Facebook provider
- */
 export declare function createFacebookProvider(): FacebookAuthProvider;
-/**
- * Creates a configured Apple Auth provider
- * @returns {OAuthProvider} Configured Apple provider
- */
 export declare function createAppleProvider(): OAuthProvider;
+export declare function createGithubProvider(): GithubAuthProvider;
+export declare function createTwitterProvider(): TwitterAuthProvider;
+export declare function createMicrosoftProvider(): OAuthProvider;

package/dist/utils/providers.js

@@ -1,30 +1,31 @@
-import { GoogleAuthProvider, FacebookAuthProvider, OAuthProvider } from 'firebase/auth';
-/**
- * Creates a configured Google Auth provider
- * @returns {GoogleAuthProvider} Configured Google provider
- */
+import { GoogleAuthProvider, FacebookAuthProvider, OAuthProvider, GithubAuthProvider, TwitterAuthProvider } from 'firebase/auth';
 export function createGoogleProvider() {
     const provider = new GoogleAuthProvider();
     provider.addScope('email');
     provider.addScope('profile');
     return provider;
 }
-/**
- * Creates a configured Facebook Auth provider
- * @returns {FacebookAuthProvider} Configured Facebook provider
- */
 export function createFacebookProvider() {
     const provider = new FacebookAuthProvider();
     provider.addScope('email');
     return provider;
 }
-/**
- * Creates a configured Apple Auth provider
- * @returns {OAuthProvider} Configured Apple provider
- */
 export function createAppleProvider() {
     const provider = new OAuthProvider('apple.com');
     provider.addScope('email');
     provider.addScope('name');
     return provider;
 }
+export function createGithubProvider() {
+    const provider = new GithubAuthProvider();
+    provider.addScope('user:email');
+    return provider;
+}
+export function createTwitterProvider() {
+    return new TwitterAuthProvider();
+}
+export function createMicrosoftProvider() {
+    const provider = new OAuthProvider('microsoft.com');
+    provider.addScope('user.read');
+    return provider;
+}

package/dist/utils/user.d.ts

@@ -1,8 +1,6 @@
 import type { User } from 'firebase/auth';
 import type { UserProfile } from '../types/auth.js';
 /**
- * Maps Firebase User to UserProfile interface
- * @param {User} user Firebase user object
- * @returns {UserProfile} Mapped user profile
+ * Maps a Firebase User object to the Firekit UserProfile interface.
  */
 export declare function mapFirebaseUserToProfile(user: User): UserProfile;

package/dist/utils/user.js

@@ -1,7 +1,5 @@
 /**
- * Maps Firebase User to UserProfile interface
- * @param {User} user Firebase user object
- * @returns {UserProfile} Mapped user profile
+ * Maps a Firebase User object to the Firekit UserProfile interface.
  */
 export function mapFirebaseUserToProfile(user) {
     return {

package/package.json

@@ -1,7 +1,13 @@
 {
 	"name": "svelte-firekit",
-	"version": "0.1.9",
+	"version": "0.2.0",
+	"description": "A Svelte library for Firebase integration",
 	"license": "MIT",
+	"author": "Giovani Rodriguez",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/codegio/svelte-firekit.git"
+	},
 	"scripts": {
 		"dev": "vite dev",
 		"build": "vite build && npm run prepack",
@@ -10,21 +16,11 @@
 		"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",
+		"lint": "prettier --check . && eslint .",
 		"format": "prettier --write .",
-		"lint": "prettier --check ."
-	},
-	"repository": {
-		"type": "git",
-		"url": "git+https://github.com/code-gio/svelte-firekit.git"
+		"test:unit": "vitest",
+		"test": "npm run test:unit -- --run"
 	},
-	"description": "A Svelte library for Firebase integration",
-	"keywords": [
-		"svelte",
-		"firebase",
-		"library",
-		"frontend"
-	],
-	"author": "Giovani Rodriguez",
 	"files": [
 		"dist",
 		"!dist/**/*.test.*",
@@ -43,51 +39,41 @@
 		}
 	},
 	"peerDependencies": {
-		"firebase": "^11.9.1",
 		"svelte": "^5.0.0",
-		"@sveltejs/kit": "^2.16.0"
+		"firebase": "^12.10.0"
 	},
 	"devDependencies": {
-		"@dnd-kit-svelte/core": "^0.0.8",
-		"@dnd-kit-svelte/modifiers": "^0.0.8",
-		"@dnd-kit-svelte/sortable": "^0.0.8",
-		"@dnd-kit-svelte/utilities": "^0.0.8",
-		"@internationalized/date": "^3.8.2",
-		"@lucide/svelte": "^0.515.0",
-		"@sveltejs/adapter-auto": "^6.0.0",
-		"@sveltejs/package": "^2.0.0",
-		"@sveltejs/vite-plugin-svelte": "^5.0.0",
-		"@tabler/icons-svelte": "^3.34.0",
-		"@tailwindcss/typography": "^0.5.15",
-		"@tailwindcss/vite": "^4.0.0",
-		"@tanstack/table-core": "^8.21.3",
-		"@types/d3-scale": "^4.0.9",
-		"@types/d3-shape": "^3.1.7",
-		"bits-ui": "^2.8.10",
-		"clsx": "^2.1.1",
-		"d3-scale": "^4.0.2",
-		"d3-shape": "^3.2.0",
-		"layerchart": "^2.0.0-next.27",
-		"mdsvex": "^0.12.6",
-		"prettier": "^3.4.2",
-		"prettier-plugin-svelte": "^3.3.3",
-		"prettier-plugin-tailwindcss": "^0.6.11",
-		"publint": "^0.3.2",
-		"shiki": "^3.7.0",
-		"svelte": "^5.0.0",
-		"svelte-check": "^4.0.0",
-		"svelte-sonner": "^1.0.5",
-		"tailwind-merge": "^3.3.1",
-		"tailwind-variants": "^1.0.0",
-		"tailwindcss": "^4.0.0",
-		"tw-animate-css": "^1.3.4",
-		"typescript": "^5.0.0",
-		"vaul-svelte": "^1.0.0-next.7",
-		"vite": "^6.2.6",
-		"zod": "^3.25.67"
+		"@eslint/compat": "^2.0.2",
+		"@eslint/js": "^9.39.2",
+		"@sveltejs/adapter-auto": "^7.0.0",
+		"@sveltejs/kit": "^2.50.2",
+		"@sveltejs/package": "^2.5.7",
+		"@sveltejs/vite-plugin-svelte": "^6.2.4",
+		"@types/node": "^24",
+		"@vitest/browser-playwright": "^4.1.0",
+		"eslint": "^9.39.2",
+		"eslint-config-prettier": "^10.1.8",
+		"eslint-plugin-svelte": "^3.14.0",
+		"globals": "^17.3.0",
+		"playwright": "^1.58.2",
+		"prettier": "^3.8.1",
+		"prettier-plugin-svelte": "^3.4.1",
+		"publint": "^0.3.17",
+		"svelte": "^5.51.0",
+		"svelte-check": "^4.4.2",
+		"typescript": "^5.9.3",
+		"typescript-eslint": "^8.54.0",
+		"vite": "^7.3.1",
+		"vitest": "^4.1.0",
+		"vitest-browser-svelte": "^2.0.2"
 	},
+	"keywords": [
+		"svelte",
+		"firebase",
+		"library",
+		"frontend"
+	],
 	"dependencies": {
-		"firebase": "^11.9.1",
-		"mode-watcher": "^1.1.0"
+		"firebase": "^12.10.0"
 	}
 }