svelte-firekit 0.1.9 → 0.2.0

package/dist/types/analytics.d.ts

@@ -1,18 +1,7 @@
-/**
- * @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>;
+    parameters?: Record<string, unknown>;
 }
-/**
- * E-commerce item interface
- */
 export interface EcommerceItem {
     item_id: string;
     item_name: string;
@@ -23,9 +12,6 @@ export interface EcommerceItem {
     quantity?: number;
     currency?: string;
 }
-/**
- * Purchase event interface
- */
 export interface PurchaseEvent {
     transaction_id: string;
     value: number;
@@ -34,51 +20,31 @@ export interface PurchaseEvent {
     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 */
+    customParameters?: Record<string, unknown>;
     enabled?: boolean;
 }

package/dist/types/analytics.js

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

package/dist/types/auth.d.ts

@@ -1,11 +1,3 @@
-/**
- * @fileoverview Authentication types and interfaces for FirekitAuth
- * @module AuthTypes
- * @version 1.0.0
- */
-/**
- * User profile interface with all Firebase user properties
- */
 export interface UserProfile {
     uid: string;
     email: string | null;
@@ -27,127 +19,85 @@ export interface UserProfile {
         phoneNumber: string | null;
         photoURL: string | null;
     }>;
-    customClaims?: Record<string, any>;
+    customClaims?: Record<string, unknown>;
 }
-/**
- * Authentication state interface
- */
 export interface AuthState {
     user: UserProfile | null;
     loading: boolean;
     initialized: boolean;
 }
-/**
- * Base authentication result interface
- */
 export interface AuthResult {
     success: boolean;
     user: UserProfile;
     method: AuthMethodType;
     timestamp: Date;
-    additionalData?: Record<string, any>;
+    additionalData?: Record<string, unknown>;
 }
-/**
- * Sign-in result interface
- */
 export interface SignInResult extends AuthResult {
     isNewUser: boolean;
     requiresEmailVerification?: boolean;
     requiresPhoneVerification?: boolean;
 }
-/**
- * Registration result interface
- */
 export interface RegistrationResult extends AuthResult {
     emailVerificationSent: boolean;
     requiresEmailVerification: boolean;
 }
-/**
- * OAuth sign-in result interface
- */
 export interface OAuthSignInResult extends SignInResult {
     provider: OAuthProviderType;
     accessToken?: string;
     refreshToken?: string;
 }
-/**
- * Phone verification result interface
- */
 export interface PhoneVerificationResult {
     verificationId: string;
     confirm: (code: string) => Promise<SignInResult>;
 }
-/**
- * Password update result interface
- */
 export interface PasswordUpdateResult {
     success: boolean;
     message: string;
     code?: string;
 }
-/**
- * Account deletion result interface
- */
 export interface AccountDeletionResult {
     success: boolean;
     message: string;
 }
-/**
- * User registration data interface
- */
 export interface UserRegistrationData {
     email: string;
     password: string;
     displayName?: string;
     photoURL?: string;
 }
-/**
- * User profile update data interface
- */
 export interface UserProfileUpdateData {
     displayName?: string;
     photoURL?: string;
 }
-/**
- * Profile update result interface
- */
 export interface ProfileUpdateResult {
     success: boolean;
     user: UserProfile;
     updatedFields: string[];
     message: string;
 }
-/**
- * Email verification result interface
- */
 export interface EmailVerificationResult {
     success: boolean;
     message: string;
     emailSent: boolean;
 }
-/**
- * Password reset result interface
- */
 export interface PasswordResetResult {
     success: boolean;
     message: string;
     emailSent: boolean;
 }
-/**
- * OAuth provider types
- */
-export type OAuthProviderType = 'google' | 'facebook' | 'apple' | 'microsoft' | 'github' | 'twitter';
-/**
- * Authentication method types
- */
-export type AuthMethodType = 'email' | 'phone' | 'google' | 'facebook' | 'apple' | 'microsoft' | 'github' | 'twitter' | 'anonymous';
-/**
- * Authentication event types
- */
+export type OAuthProviderType = 'google' | 'facebook' | 'apple' | 'microsoft' | 'github' | 'twitter' | 'saml' | 'oidc';
+export type AuthMethodType = 'email' | 'phone' | 'google' | 'facebook' | 'apple' | 'microsoft' | 'github' | 'twitter' | 'anonymous' | 'custom' | 'saml' | 'oidc';
+export interface MFAEnrollmentResult {
+    success: boolean;
+    factorUid?: string;
+    message: string;
+}
+export interface MFAChallengeResult {
+    verificationId: string;
+    resolver: import('firebase/auth').MultiFactorResolver;
+}
 export type AuthEventType = 'signIn' | 'signOut' | 'signUp' | 'passwordReset' | 'emailVerification' | 'profileUpdate' | 'accountDeletion' | 'error';
-/**
- * Authentication event data interface
- */
 export interface AuthEventData {
     type: AuthEventType;
     user?: UserProfile | null;
@@ -155,24 +105,13 @@ export interface AuthEventData {
     error?: FirekitAuthError;
     timestamp: Date;
 }
-/**
- * Authentication configuration interface
- */
 export interface AuthConfig {
-    /** Enable automatic Firestore user data sync */
     enableFirestoreSync?: boolean;
-    /** Custom Firestore collection path for users */
     usersCollectionPath?: string;
-    /** Enable email verification on registration */
     requireEmailVerification?: boolean;
-    /** Custom error message overrides */
     errorMessages?: Partial<Record<AuthErrorCode, string>>;
-    /** Enable analytics tracking */
     enableAnalytics?: boolean;
 }
-/**
- * Authentication error codes enum
- */
 export declare enum AuthErrorCode {
     EMAIL_ALREADY_IN_USE = "auth/email-already-in-use",
     INVALID_EMAIL = "auth/invalid-email",
@@ -198,19 +137,10 @@ export declare enum AuthErrorCode {
     KEYBOARD_NOT_SUPPORTED = "auth/keychain-error",
     INTERNAL_ERROR = "auth/internal-error"
 }
-/**
- * Custom authentication error class
- */
 export declare class FirekitAuthError extends Error {
     code: AuthErrorCode | string;
-    originalError?: any | undefined;
-    constructor(code: AuthErrorCode | string, message: string, originalError?: any | undefined);
-    /**
-     * Get user-friendly error message
-     */
+    originalError?: unknown | undefined;
+    constructor(code: AuthErrorCode | string, message: string, originalError?: unknown | undefined);
     getFriendlyMessage(): string;
-    /**
-     * Check if error is retryable
-     */
     isRetryable(): boolean;
 }

package/dist/types/auth.js

@@ -1,11 +1,3 @@
-/**
- * @fileoverview Authentication types and interfaces for FirekitAuth
- * @module AuthTypes
- * @version 1.0.0
- */
-/**
- * Authentication error codes enum
- */
 export var AuthErrorCode;
 (function (AuthErrorCode) {
     AuthErrorCode["EMAIL_ALREADY_IN_USE"] = "auth/email-already-in-use";
@@ -32,9 +24,6 @@ export var AuthErrorCode;
     AuthErrorCode["KEYBOARD_NOT_SUPPORTED"] = "auth/keychain-error";
     AuthErrorCode["INTERNAL_ERROR"] = "auth/internal-error";
 })(AuthErrorCode || (AuthErrorCode = {}));
-/**
- * Custom authentication error class
- */
 export class FirekitAuthError extends Error {
     code;
     originalError;
@@ -44,9 +33,6 @@ export class FirekitAuthError extends Error {
         this.originalError = originalError;
         this.name = 'FirekitAuthError';
     }
-    /**
-     * Get user-friendly error message
-     */
     getFriendlyMessage() {
         switch (this.code) {
             case AuthErrorCode.EMAIL_ALREADY_IN_USE:
@@ -91,9 +77,6 @@ export class FirekitAuthError extends Error {
                 return this.message;
         }
     }
-    /**
-     * Check if error is retryable
-     */
     isRetryable() {
         const retryableCodes = [
             AuthErrorCode.NETWORK_REQUEST_FAILED,

package/dist/types/collection.d.ts

@@ -1,173 +1,86 @@
-/**
- * @fileoverview Collection types and interfaces for FirekitCollection
- * @module CollectionTypes
- * @version 1.0.0
- */
 import type { QueryConstraint } from 'firebase/firestore';
-/**
- * Collection state interface containing all reactive properties
- */
 export interface CollectionState<T> {
-    /** Array of documents in the collection */
     data: T[];
-    /** Loading state indicator */
     loading: boolean;
-    /** Whether collection has been initialized */
     initialized: boolean;
-    /** Current error state */
     error: CollectionError | null;
-    /** Whether collection is empty */
     empty: boolean;
-    /** Number of documents */
     size: number;
-    /** Last update timestamp */
     lastUpdated: Date | null;
 }
-/**
- * Collection configuration options
- */
 export interface CollectionOptions {
-    /** Enable real-time updates (default: true) */
     realtime?: boolean;
-    /** Include metadata changes in updates (default: false) */
     includeMetadata?: boolean;
-    /** Data source preference (default: 'default') */
     source?: 'default' | 'server' | 'cache';
-    /** Transform function for documents */
-    transform?: (doc: any) => any;
-    /** Filter function for documents */
-    filter?: (doc: any) => boolean;
-    /** Sort function for documents */
-    sort?: (a: any, b: any) => number;
-    /** Pagination settings */
+    transform?: (doc: unknown) => unknown;
+    filter?: (doc: unknown) => boolean;
+    sort?: (a: unknown, b: unknown) => number;
     pagination?: PaginationConfig;
-    /** Cache configuration */
     cache?: CacheConfig;
-    /** Error handling configuration */
     errorHandling?: ErrorHandlingConfig;
 }
-/**
- * Pagination configuration
- */
 export interface PaginationConfig {
-    /** Enable pagination */
     enabled: boolean;
-    /** Page size */
     pageSize: number;
-    /** Current page number */
     currentPage: number;
-    /** Auto-load next page when scrolling */
     autoLoad?: boolean;
-    /** Cursor for pagination */
-    cursor?: any;
+    cursor?: unknown;
 }
-/**
- * Cache configuration
- */
 export interface CacheConfig {
-    /** Enable caching */
     enabled: boolean;
-    /** Cache duration in milliseconds */
     ttl: number;
-    /** Maximum cache size */
     maxSize?: number;
-    /** Cache key strategy */
     keyStrategy?: 'path' | 'query' | 'custom';
-    /** Custom cache key function */
     customKey?: (path: string, constraints: QueryConstraint[]) => string;
 }
-/**
- * Error handling configuration
- */
 export interface ErrorHandlingConfig {
-    /** Enable automatic retry on errors */
     autoRetry?: boolean;
-    /** Maximum retry attempts */
     maxRetries?: number;
-    /** Retry delay in milliseconds */
     retryDelay?: number;
-    /** Custom error handler */
     onError?: (error: CollectionError) => void;
 }
-/**
- * Query constraint builder interface
- */
 export interface QueryBuilder<T> {
-    /** Add where constraint */
-    where(field: string, operator: FirestoreOperator, value: any): QueryBuilder<T>;
-    /** Add orderBy constraint */
+    where(field: string, operator: FirestoreOperator, value: unknown): QueryBuilder<T>;
     orderBy(field: string, direction?: 'asc' | 'desc'): QueryBuilder<T>;
-    /** Add limit constraint */
     limit(count: number): QueryBuilder<T>;
-    /** Add startAt constraint */
-    startAt(...values: any[]): QueryBuilder<T>;
-    /** Add startAfter constraint */
-    startAfter(...values: any[]): QueryBuilder<T>;
-    /** Add endAt constraint */
-    endAt(...values: any[]): QueryBuilder<T>;
-    /** Add endBefore constraint */
-    endBefore(...values: any[]): QueryBuilder<T>;
-    /** Build the query */
+    startAt(...values: unknown[]): QueryBuilder<T>;
+    startAfter(...values: unknown[]): QueryBuilder<T>;
+    endAt(...values: unknown[]): QueryBuilder<T>;
+    endBefore(...values: unknown[]): QueryBuilder<T>;
     build(): QueryConstraint[];
 }
-/**
- * Firestore query operators
- */
 export type FirestoreOperator = '<' | '<=' | '==' | '!=' | '>=' | '>' | 'array-contains' | 'array-contains-any' | 'in' | 'not-in';
-/**
- * Collection change types
- */
 export type CollectionChangeType = 'added' | 'modified' | 'removed';
-/**
- * Document change information
- */
 export interface DocumentChange<T> {
-    /** Type of change */
     type: CollectionChangeType;
-    /** Document data */
     doc: T;
-    /** Old index in collection */
     oldIndex: number;
-    /** New index in collection */
     newIndex: number;
-    /** Change timestamp */
     timestamp: Date;
 }
-/**
- * Collection metadata interface
- */
 export interface CollectionMetadata {
-    /** Whether data is from cache */
     fromCache: boolean;
-    /** Whether there are pending writes */
     hasPendingWrites: boolean;
-    /** Sync state */
     syncState: 'synced' | 'local' | 'unknown';
-    /** Last sync timestamp */
     lastSyncTime?: Date;
 }
-/**
- * Collection statistics
- */
-export interface CollectionStats {
-    /** Total number of documents */
-    totalDocuments: number;
-    /** Number of read operations */
-    readCount: number;
-    /** Number of write operations */
-    writeCount: number;
-    /** Cache hit rate */
-    cacheHitRate: number;
-    /** Average query time */
-    averageQueryTime: number;
-    /** Last activity timestamp */
-    lastActivity: Date;
-    /** Memory usage in bytes */
-    memoryUsage: number;
+export interface CollectionAggregation {
+    count?: number;
+    sum?: number;
+    average?: number;
+}
+export interface CollectionListenerConfig {
+    includeMetadata?: boolean;
+    onError?: (error: CollectionError) => void;
+    onData?: (data: unknown[]) => void;
+    onChange?: (changes: DocumentChange<unknown>[]) => void;
+    autoRetry?: boolean;
+    retryConfig?: {
+        maxAttempts: number;
+        baseDelay: number;
+        maxDelay: number;
+    };
 }
-/**
- * Collection error codes enum
- */
 export declare enum CollectionErrorCode {
     PERMISSION_DENIED = "collection/permission-denied",
     NOT_FOUND = "collection/not-found",
@@ -194,142 +107,35 @@ export declare enum CollectionErrorCode {
     LISTENER_ERROR = "collection/listener-error",
     CACHE_ERROR = "collection/cache-error",
     CACHE_FULL = "collection/cache-full",
-    CACHE_CORRUPTED = "collection/cache-corrupted",
     PAGINATION_ERROR = "collection/pagination-error",
     INVALID_CURSOR = "collection/invalid-cursor",
     TRANSFORM_ERROR = "collection/transform-error",
     FILTER_ERROR = "collection/filter-error",
     UNKNOWN = "collection/unknown"
 }
-/**
- * Custom collection error class
- */
 export declare class CollectionError extends Error {
     code: CollectionErrorCode;
     path?: string | undefined;
     query?: QueryConstraint[] | undefined;
-    originalError?: any | undefined;
-    context?: Record<string, any> | undefined;
-    constructor(code: CollectionErrorCode, message: string, path?: string | undefined, query?: QueryConstraint[] | undefined, originalError?: any | undefined, context?: Record<string, any> | undefined);
-    /**
-     * Get user-friendly error message
-     */
+    originalError?: unknown | undefined;
+    context?: Record<string, unknown> | undefined;
+    constructor(code: CollectionErrorCode, message: string, path?: string | undefined, query?: QueryConstraint[] | undefined, originalError?: unknown | undefined, context?: Record<string, unknown> | undefined);
     getFriendlyMessage(): string;
-    /**
-     * Check if error is retryable
-     */
     isRetryable(): boolean;
-    /**
-     * Check if error requires user authentication
-     */
     requiresAuth(): boolean;
-    /**
-     * Check if error is related to query issues
-     */
     isQueryError(): boolean;
-    /**
-     * Check if error is network related
-     */
-    isNetworkError(): boolean;
-    /**
-     * Convert to JSON for logging/debugging
-     */
-    toJSON(): Record<string, any>;
+    toJSON(): Record<string, unknown>;
 }
-/**
- * Collection subscription interface
- */
 export interface CollectionSubscription {
-    /** Unsubscribe from collection changes */
     unsubscribe: () => void;
-    /** Whether subscription is active */
     active: boolean;
-    /** Subscription configuration */
     config: CollectionOptions;
-    /** Subscription statistics */
-    stats: CollectionStats;
 }
-/**
- * Collection query result interface
- */
 export interface CollectionQueryResult<T> {
-    /** Query result documents */
     docs: T[];
-    /** Query metadata */
     metadata: CollectionMetadata;
-    /** Total count (if available) */
     totalCount?: number;
-    /** Whether there are more documents */
     hasMore?: boolean;
-    /** Next page cursor */
-    nextCursor?: any;
-    /** Previous page cursor */
-    prevCursor?: any;
-}
-/**
- * Collection aggregation result
- */
-export interface CollectionAggregation {
-    /** Count of documents */
-    count?: number;
-    /** Sum of numeric field */
-    sum?: number;
-    /** Average of numeric field */
-    average?: number;
-    /** Minimum value */
-    min?: any;
-    /** Maximum value */
-    max?: any;
-    /** Custom aggregation results */
-    custom?: Record<string, any>;
-}
-/**
- * Real-time collection listener configuration
- */
-export interface ListenerConfig {
-    /** Include metadata changes */
-    includeMetadata?: boolean;
-    /** Custom error handler */
-    onError?: (error: CollectionError) => void;
-    /** Custom data handler */
-    onData?: (data: any[]) => void;
-    /** Custom change handler */
-    onChange?: (changes: DocumentChange<any>[]) => void;
-    /** Whether to automatically retry on connection issues */
-    autoRetry?: boolean;
-    /** Retry configuration */
-    retryConfig?: {
-        maxAttempts: number;
-        baseDelay: number;
-        maxDelay: number;
-    };
-}
-/**
- * Collection performance metrics
- */
-export interface CollectionPerformanceMetrics {
-    /** Query execution time in milliseconds */
-    queryTime: number;
-    /** Network latency */
-    networkLatency: number;
-    /** Cache performance */
-    cachePerformance: {
-        hits: number;
-        misses: number;
-        hitRate: number;
-    };
-    /** Memory usage */
-    memoryUsage: {
-        current: number;
-        peak: number;
-        average: number;
-    };
-    /** Document processing time */
-    processingTime: number;
-    /** Listener performance */
-    listenerPerformance: {
-        updateFrequency: number;
-        averageUpdateTime: number;
-        totalUpdates: number;
-    };
+    nextCursor?: unknown;
+    prevCursor?: unknown;
 }