@umituz/web-firebase 2.1.1 → 3.0.1

package/src/domains/auth/types/auth-service.interface.ts

@@ -0,0 +1,72 @@
+/**
+ * Auth Service Interface
+ * @description Abstract interface for authentication operations
+ */
+
+import type { UserCredential } from 'firebase/auth'
+import type { AuthUser } from '../entities'
+
+export interface IAuthService {
+  /**
+   * Sign in with email and password
+   */
+  signIn(email: string, password: string): Promise<UserCredential>
+
+  /**
+   * Sign up with email, password, and display name
+   */
+  signUp(email: string, password: string, displayName: string): Promise<UserCredential>
+
+  /**
+   * Sign in with Google OAuth
+   */
+  signInWithGoogle(): Promise<UserCredential>
+
+  /**
+   * Sign out current user
+   */
+  signOut(): Promise<void>
+
+  /**
+   * Send password reset email
+   */
+  sendPasswordReset(email: string): Promise<void>
+
+  /**
+   * Resend email verification
+   */
+  resendEmailVerification(): Promise<void>
+
+  /**
+   * Update user profile (displayName, photoURL)
+   */
+  updateProfile(updates: { displayName?: string; photoURL?: string }): Promise<void>
+
+  /**
+   * Update user email (requires password)
+   */
+  updateEmail(newEmail: string, password: string): Promise<void>
+
+  /**
+   * Update user password (requires current password)
+   */
+  updatePassword(currentPassword: string, newPassword: string): Promise<void>
+
+  /**
+   * Delete user account (requires password)
+   */
+  deleteAccount(password: string): Promise<void>
+
+  /**
+   * Get current authenticated user
+   */
+  getCurrentUser(): AuthUser | null
+
+  /**
+   * Subscribe to auth state changes
+   */
+  onAuthStateChanged(
+    callback: (user: AuthUser | null) => void,
+    onError?: (error: Error) => void
+  ): () => void
+}

package/src/domains/auth/types/index.ts

@@ -0,0 +1,5 @@
+/**
+ * Auth Domain Types
+ */
+
+export * from './auth-service.interface';

package/src/domains/firestore/entities/index.ts

@@ -0,0 +1,82 @@
+/**
+ * Firestore Domain Entities
+ * @description Core Firestore-related entities
+ */
+
+/**
+ * User Profile Value Object
+ * Immutable user profile data
+ */
+export interface UserProfile {
+  readonly id: string
+  readonly email: string
+  readonly displayName: string
+  readonly photoURL?: string
+  readonly phoneNumber?: string
+  readonly createdAt: number
+  readonly updatedAt: number
+  readonly lastLoginAt: number
+  readonly emailVerified: boolean
+}
+
+/**
+ * User Notifications Settings
+ */
+export interface UserNotifications {
+  email: boolean
+  push: boolean
+  marketing: boolean
+  security: boolean
+  weeklyDigest: boolean
+}
+
+/**
+ * User Privacy Settings
+ */
+export interface UserPrivacy {
+  profileVisibility: 'public' | 'private'
+  showEmail: boolean
+  showPhone: boolean
+  dataSharing: boolean
+}
+
+/**
+ * User Settings Value Object
+ */
+export interface UserSettings {
+  theme: 'light' | 'dark' | 'system'
+  language: string
+  timezone: string
+  currency: string
+  notifications: UserNotifications
+  privacy: UserPrivacy
+}
+
+/**
+ * User Subscription Value Object
+ */
+export interface UserSubscription {
+  plan: 'free' | 'standard' | 'professional' | 'business'
+  status: 'active' | 'inactive' | 'canceled' | 'past_due'
+  polarCustomerId?: string
+  polarSubscriptionId?: string
+  currentPeriodStart?: number
+  currentPeriodEnd?: number
+  cancelAtPeriodEnd: boolean
+  readonly createdAt: number
+  readonly updatedAt: number
+}
+
+/**
+ * User Aggregate Root
+ * Main user document containing all user-related data
+ */
+export interface User {
+  readonly profile: UserProfile
+  settings: UserSettings
+  subscription: UserSubscription
+  connectedAccounts?: any[]
+  content?: any[]
+  analytics?: any
+  credits?: any
+}

package/src/domains/firestore/index.ts

@@ -0,0 +1,13 @@
+/**
+ * Firestore Domain
+ * Complete Cloud Firestore integration
+ */
+
+// Entities
+export * from './entities'
+
+// Types
+export * from './types'
+
+// Services
+export * from './services'

package/src/domains/firestore/services/firestore.service.ts

@@ -0,0 +1,191 @@
+/**
+ * Firestore Service
+ * @description Firebase Firestore implementation of IFirestoreService
+ */
+
+import {
+  doc,
+  getDoc,
+  setDoc,
+  updateDoc,
+  deleteDoc,
+  query,
+  where,
+  onSnapshot,
+  collection,
+  getDocs,
+} from 'firebase/firestore'
+import { getFirebaseDB } from '../../../infrastructure/firebase/client'
+import type { IFirestoreService } from '../types'
+import type { User } from '../entities'
+
+class FirestoreService implements IFirestoreService {
+  private get db() {
+    return getFirebaseDB()
+  }
+
+  private readonly USERS_COLLECTION = 'users'
+
+  async getUser(userId: string): Promise<User | null> {
+    try {
+      const docRef = doc(this.db, this.USERS_COLLECTION, userId)
+      const snap = await getDoc(docRef)
+
+      if (!snap.exists()) {
+        return null
+      }
+
+      return snap.data() as User
+    } catch (error) {
+      throw new Error('User not found')
+    }
+  }
+
+  async getUserByEmail(email: string): Promise<User | null> {
+    try {
+      const q = query(collection(this.db, this.USERS_COLLECTION), where('profile.email', '==', email))
+      const snap = await getDocs(q)
+
+      if (snap.empty) {
+        return null
+      }
+
+      const doc = snap.docs[0]
+      return doc.data() as User
+    } catch (error) {
+      throw new Error('Failed to query user')
+    }
+  }
+
+  async createUser(userId: string, data: Partial<User>): Promise<void> {
+    try {
+      const docRef = doc(this.db, this.USERS_COLLECTION, userId)
+      await setDoc(docRef, data, { merge: true })
+    } catch (error) {
+      throw new Error('Failed to create user')
+    }
+  }
+
+  async updateUser(userId: string, data: Partial<User>): Promise<void> {
+    try {
+      const docRef = doc(this.db, this.USERS_COLLECTION, userId)
+      await updateDoc(docRef, {
+        ...data,
+        'profile.updatedAt': Date.now(),
+      } as any)
+    } catch (error) {
+      throw new Error('Failed to update user')
+    }
+  }
+
+  async deleteUser(userId: string): Promise<void> {
+    try {
+      const docRef = doc(this.db, this.USERS_COLLECTION, userId)
+      await deleteDoc(docRef)
+    } catch (error) {
+      throw new Error('Failed to delete user')
+    }
+  }
+
+  async updateProfile(
+    userId: string,
+    updates: Partial<Pick<User['profile'], 'displayName' | 'photoURL' | 'phoneNumber'>>
+  ): Promise<void> {
+    try {
+      const docRef = doc(this.db, this.USERS_COLLECTION, userId)
+      const updateData: any = {
+        'profile.updatedAt': Date.now(),
+      }
+
+      if (updates.displayName !== undefined) {
+        updateData['profile.displayName'] = updates.displayName
+      }
+      if (updates.photoURL !== undefined) {
+        updateData['profile.photoURL'] = updates.photoURL
+      }
+      if (updates.phoneNumber !== undefined) {
+        updateData['profile.phoneNumber'] = updates.phoneNumber
+      }
+
+      await updateDoc(docRef, updateData)
+    } catch (error) {
+      throw new Error('Failed to update profile')
+    }
+  }
+
+  async updateSettings(userId: string, settings: Partial<User['settings']>): Promise<void> {
+    try {
+      const docRef = doc(this.db, this.USERS_COLLECTION, userId)
+      await updateDoc(docRef, {
+        settings: {
+          ...settings,
+          updatedAt: Date.now(),
+        },
+      } as any)
+    } catch (error) {
+      throw new Error('Failed to update settings')
+    }
+  }
+
+  async updateSubscription(userId: string, subscription: Partial<User['subscription']>): Promise<void> {
+    try {
+      const docRef = doc(this.db, this.USERS_COLLECTION, userId)
+      await updateDoc(docRef, {
+        subscription: {
+          ...subscription,
+          updatedAt: Date.now(),
+        },
+      } as any)
+    } catch (error) {
+      throw new Error('Failed to update subscription')
+    }
+  }
+
+  async updateLastLogin(userId: string): Promise<void> {
+    try {
+      const docRef = doc(this.db, this.USERS_COLLECTION, userId)
+      await updateDoc(docRef, {
+        'profile.lastLoginAt': Date.now(),
+      } as any)
+    } catch (error) {
+      throw new Error('Failed to update last login')
+    }
+  }
+
+  async queryUsers(constraints: any[]): Promise<User[]> {
+    try {
+      const q = query(collection(this.db, this.USERS_COLLECTION), ...constraints)
+      const snap = await getDocs(q)
+      return snap.docs.map((doc) => doc.data() as User)
+    } catch (error) {
+      throw new Error('Failed to query users')
+    }
+  }
+
+  subscribeToUser(
+    userId: string,
+    callback: (user: User | null) => void,
+    onError?: (error: Error) => void
+  ): () => void {
+    const docRef = doc(this.db, this.USERS_COLLECTION, userId)
+
+    const unsubscribe = onSnapshot(
+      docRef,
+      (snap) => {
+        if (snap.exists()) {
+          callback(snap.data() as User)
+        } else {
+          callback(null)
+        }
+      },
+      (error) => {
+        onError?.(error as Error)
+      }
+    )
+
+    return unsubscribe
+  }
+}
+
+// Export class and singleton instance
+export const firestoreService = new FirestoreService()

package/src/domains/firestore/services/index.ts

@@ -0,0 +1,7 @@
+/**
+ * Firestore Domain Services
+ * Subpath: @umituz/web-firebase/firestore
+ */
+
+export { firestoreService } from './firestore.service'
+export type { IFirestoreService } from '../types'

package/src/domains/firestore/types/firestore-service.interface.ts

@@ -0,0 +1,64 @@
+/**
+ * Firestore Service Interface
+ * @description Abstract interface for Firestore operations
+ */
+
+import type { QueryConstraint } from 'firebase/firestore'
+import type { User } from '../entities'
+
+export interface IFirestoreService {
+  /**
+   * Get user by ID
+   */
+  getUser(userId: string): Promise<User | null>
+
+  /**
+   * Get user by email
+   */
+  getUserByEmail(email: string): Promise<User | null>
+
+  /**
+   * Create user
+   */
+  createUser(userId: string, data: Partial<User>): Promise<void>
+
+  /**
+   * Update user
+   */
+  updateUser(userId: string, data: Partial<User>): Promise<void>
+
+  /**
+   * Delete user
+   */
+  deleteUser(userId: string): Promise<void>
+
+  /**
+   * Update user profile
+   */
+  updateProfile(userId: string, updates: Partial<Pick<User['profile'], 'displayName' | 'photoURL' | 'phoneNumber'>>): Promise<void>
+
+  /**
+   * Update user settings
+   */
+  updateSettings(userId: string, settings: Partial<User['settings']>): Promise<void>
+
+  /**
+   * Update user subscription
+   */
+  updateSubscription(userId: string, subscription: Partial<User['subscription']>): Promise<void>
+
+  /**
+   * Update last login timestamp
+   */
+  updateLastLogin(userId: string): Promise<void>
+
+  /**
+   * Query users with constraints
+   */
+  queryUsers(constraints: QueryConstraint[]): Promise<User[]>
+
+  /**
+   * Subscribe to user document changes
+   */
+  subscribeToUser(userId: string, callback: (user: User | null) => void, onError?: (error: Error) => void): () => void
+}

package/src/domains/firestore/types/index.ts

@@ -0,0 +1,5 @@
+/**
+ * Firestore Domain Types
+ */
+
+export * from './firestore-service.interface'

package/src/domains/storage/entities/index.ts

@@ -0,0 +1,94 @@
+/**
+ * Storage Domain Entities
+ * @description File and storage-related entities
+ */
+
+/**
+ * File Metadata Entity
+ * Contains metadata about uploaded files
+ */
+export interface FileMetadata {
+  readonly id: string
+  readonly name: string
+  readonly fullPath: string
+  readonly contentType: string
+  readonly size: number
+  readonly createdAt: number
+  readonly updatedAt: number
+  readonly userId: string
+  readonly type: FileType
+  category?: FileCategory
+  description?: string
+  tags?: string[]
+}
+
+/**
+ * File Types
+ */
+export type FileType = 'image' | 'video' | 'audio' | 'document' | 'other'
+
+/**
+ * File Categories
+ */
+export type FileCategory = 'profile' | 'content' | 'document' | 'attachment' | 'backup'
+
+/**
+ * Upload Progress Entity
+ * Tracks upload progress for resumable uploads
+ */
+export interface UploadProgress {
+  bytesTransferred: number
+  totalBytes: number
+  progress: number // 0-100
+  state: UploadState
+  speed?: number // bytes per second
+  remaining?: number // seconds remaining
+}
+
+/**
+ * Upload States
+ */
+export type UploadState =
+  | 'paused'
+  | 'running'
+  | 'success'
+  | 'canceled'
+  | 'error'
+
+/**
+ * File Upload Result Entity
+ * Result of a file upload operation
+ */
+export interface FileUploadResult {
+  readonly id: string
+  readonly name: string
+  readonly fullPath: string
+  readonly downloadURL: string
+  readonly contentType: string
+  readonly size: number
+  readonly createdAt: number
+}
+
+// Export as UploadResult for backward compatibility
+export type UploadResult = FileUploadResult
+
+/**
+ * Upload Options
+ * Configuration for file uploads
+ */
+export interface UploadOptions {
+  onProgress?: (progress: UploadProgress) => void
+  metadata?: FileMetadata
+  customMetadata?: Record<string, string>
+}
+
+/**
+ * Storage Statistics
+ */
+export interface StorageStats {
+  totalFiles: number
+  totalSize: number
+  filesByType: Record<FileType, number>
+  filesByCategory: Record<FileCategory, number>
+  lastUploadAt?: number
+}

package/src/domains/storage/index.ts

@@ -0,0 +1,13 @@
+/**
+ * Storage Domain
+ * Complete Firebase Storage integration
+ */
+
+// Entities
+export * from './entities'
+
+// Types
+export * from './types'
+
+// Services
+export * from './services'

package/src/domains/storage/services/index.ts

@@ -0,0 +1,7 @@
+/**
+ * Storage Domain Services
+ * Subpath: @umituz/web-firebase/storage
+ */
+
+export { storageService } from './storage.service'
+export type { IStorageService } from '../types'