@umituz/web-firebase 1.0.5 → 2.0.1

package/dist/file.repository.interface-v5vHgVsZ.d.mts

@@ -0,0 +1,241 @@
+/**
+ * File Domain Entities
+ * @description File and storage-related entities
+ */
+/**
+ * File Metadata Entity
+ * Contains metadata about uploaded files
+ */
+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
+ */
+type FileType = 'image' | 'video' | 'audio' | 'document' | 'other';
+/**
+ * File Categories
+ */
+type FileCategory = 'profile' | 'content' | 'document' | 'attachment' | 'backup';
+/**
+ * Upload Progress Entity
+ * Tracks upload progress for resumable uploads
+ */
+interface UploadProgress {
+    bytesTransferred: number;
+    totalBytes: number;
+    progress: number;
+    state: UploadState;
+    speed?: number;
+    remaining?: number;
+}
+/**
+ * Upload States
+ */
+type UploadState = 'paused' | 'running' | 'success' | 'canceled' | 'error';
+/**
+ * File Upload Result Entity
+ * Result of a file upload operation
+ */
+interface FileUploadResult {
+    readonly id: string;
+    readonly name: string;
+    readonly fullPath: string;
+    readonly downloadURL: string;
+    readonly contentType: string;
+    readonly size: number;
+    readonly createdAt: number;
+}
+type UploadResult = FileUploadResult;
+/**
+ * Upload Options
+ * Configuration for file uploads
+ */
+interface UploadOptions {
+    onProgress?: (progress: UploadProgress) => void;
+    metadata?: FileMetadata;
+    customMetadata?: Record<string, string>;
+}
+/**
+ * File Validation Options
+ */
+interface FileValidationOptions {
+    maxSizeBytes?: number;
+    maxSizeMB?: number;
+    allowedTypes?: string[];
+    allowedExtensions?: string[];
+}
+/**
+ * Validation Result
+ */
+interface ValidationResult {
+    valid: boolean;
+    error?: string;
+    errorCode?: FileErrorCode;
+}
+/**
+ * File Error Codes
+ */
+declare enum FileErrorCode {
+    FILE_TOO_LARGE = "FILE_TOO_LARGE",
+    INVALID_TYPE = "INVALID_TYPE",
+    INVALID_EXTENSION = "INVALID_EXTENSION",
+    UPLOAD_FAILED = "UPLOAD_FAILED",
+    DOWNLOAD_FAILED = "DOWNLOAD_FAILED",
+    DELETE_FAILED = "DELETE_FAILED",
+    FILE_NOT_FOUND = "FILE_NOT_FOUND",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    CANCELLED = "CANCELLED"
+}
+/**
+ * File Filters
+ */
+interface FileFilters {
+    type?: FileType;
+    category?: FileCategory;
+    startDate?: number;
+    endDate?: number;
+    minSize?: number;
+    maxSize?: number;
+    tags?: string[];
+}
+/**
+ * File Query Result
+ */
+interface FileQueryResult {
+    files: FileMetadata[];
+    totalCount: number;
+    hasMore: boolean;
+    lastDocId?: string;
+}
+/**
+ * Storage Statistics
+ */
+interface StorageStats {
+    totalFiles: number;
+    totalSize: number;
+    filesByType: Record<FileType, number>;
+    filesByCategory: Record<FileCategory, number>;
+    lastUploadAt?: number;
+}
+
+/**
+ * File Repository Interface
+ * @description Defines contract for file storage operations
+ */
+
+/**
+ * File Repository Interface
+ * Defines operations for file storage and management
+ */
+interface IFileRepository {
+    /**
+     * Upload file to storage
+     */
+    uploadFile(userId: string, path: string, file: File | Blob, options?: UploadOptions): Promise<UploadResult>;
+    /**
+     * Upload image with automatic categorization
+     */
+    uploadImage(userId: string, file: File, filename?: string): Promise<UploadResult>;
+    /**
+     * Upload video with automatic categorization
+     */
+    uploadVideo(userId: string, file: File, filename?: string): Promise<UploadResult>;
+    /**
+     * Upload document with automatic categorization
+     */
+    uploadDocument(userId: string, file: File, filename?: string): Promise<UploadResult>;
+    /**
+     * Upload profile picture
+     */
+    uploadProfilePicture(userId: string, file: File): Promise<UploadResult>;
+    /**
+     * Get download URL for a file
+     */
+    getDownloadURL(path: string): Promise<string>;
+    /**
+     * Delete file by path
+     */
+    deleteFile(path: string): Promise<void>;
+    /**
+     * Delete all user files
+     */
+    deleteUserFiles(userId: string): Promise<void>;
+    /**
+     * Delete user image
+     */
+    deleteImage(userId: string, filename: string): Promise<void>;
+    /**
+     * Delete user video
+     */
+    deleteVideo(userId: string, filename: string): Promise<void>;
+    /**
+     * Delete profile picture
+     */
+    deleteProfilePicture(userId: string, filename: string): Promise<void>;
+    /**
+     * List user files
+     */
+    listUserFiles(userId: string, path?: string): Promise<string[]>;
+    /**
+     * List user images
+     */
+    listUserImages(userId: string): Promise<string[]>;
+    /**
+     * List user videos
+     */
+    listUserVideos(userId: string): Promise<string[]>;
+    /**
+     * Get file metadata
+     */
+    getFileMetadata(path: string): Promise<FileMetadata>;
+    /**
+     * Query files with filters
+     */
+    queryFiles(userId: string, filters?: FileFilters): Promise<FileQueryResult>;
+    /**
+     * Get storage statistics
+     */
+    getStorageStats(userId: string): Promise<StorageStats>;
+    /**
+     * Validate file before upload
+     */
+    validateFile(file: File, options?: {
+        maxSizeBytes?: number;
+        maxSizeMB?: number;
+        allowedTypes?: string[];
+    }): boolean;
+    /**
+     * Check if file is an image
+     */
+    isImageFile(file: File): boolean;
+    /**
+     * Check if file is a video
+     */
+    isVideoFile(file: File): boolean;
+    /**
+     * Check if file is a document
+     */
+    isDocumentFile(file: File): boolean;
+    /**
+     * Generate unique filename
+     */
+    generateUniqueFilename(originalName: string): string;
+    /**
+     * Get file extension
+     */
+    getFileExtension(filename: string): string;
+}
+
+export { type FileCategory as F, type IFileRepository as I, type StorageStats as S, type UploadOptions as U, type ValidationResult as V, FileErrorCode as a, type FileFilters as b, type FileMetadata as c, type FileQueryResult as d, type FileType as e, type FileUploadResult as f, type FileValidationOptions as g, type UploadProgress as h, type UploadResult as i, type UploadState as j };

package/dist/file.repository.interface-v5vHgVsZ.d.ts

@@ -0,0 +1,241 @@
+/**
+ * File Domain Entities
+ * @description File and storage-related entities
+ */
+/**
+ * File Metadata Entity
+ * Contains metadata about uploaded files
+ */
+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
+ */
+type FileType = 'image' | 'video' | 'audio' | 'document' | 'other';
+/**
+ * File Categories
+ */
+type FileCategory = 'profile' | 'content' | 'document' | 'attachment' | 'backup';
+/**
+ * Upload Progress Entity
+ * Tracks upload progress for resumable uploads
+ */
+interface UploadProgress {
+    bytesTransferred: number;
+    totalBytes: number;
+    progress: number;
+    state: UploadState;
+    speed?: number;
+    remaining?: number;
+}
+/**
+ * Upload States
+ */
+type UploadState = 'paused' | 'running' | 'success' | 'canceled' | 'error';
+/**
+ * File Upload Result Entity
+ * Result of a file upload operation
+ */
+interface FileUploadResult {
+    readonly id: string;
+    readonly name: string;
+    readonly fullPath: string;
+    readonly downloadURL: string;
+    readonly contentType: string;
+    readonly size: number;
+    readonly createdAt: number;
+}
+type UploadResult = FileUploadResult;
+/**
+ * Upload Options
+ * Configuration for file uploads
+ */
+interface UploadOptions {
+    onProgress?: (progress: UploadProgress) => void;
+    metadata?: FileMetadata;
+    customMetadata?: Record<string, string>;
+}
+/**
+ * File Validation Options
+ */
+interface FileValidationOptions {
+    maxSizeBytes?: number;
+    maxSizeMB?: number;
+    allowedTypes?: string[];
+    allowedExtensions?: string[];
+}
+/**
+ * Validation Result
+ */
+interface ValidationResult {
+    valid: boolean;
+    error?: string;
+    errorCode?: FileErrorCode;
+}
+/**
+ * File Error Codes
+ */
+declare enum FileErrorCode {
+    FILE_TOO_LARGE = "FILE_TOO_LARGE",
+    INVALID_TYPE = "INVALID_TYPE",
+    INVALID_EXTENSION = "INVALID_EXTENSION",
+    UPLOAD_FAILED = "UPLOAD_FAILED",
+    DOWNLOAD_FAILED = "DOWNLOAD_FAILED",
+    DELETE_FAILED = "DELETE_FAILED",
+    FILE_NOT_FOUND = "FILE_NOT_FOUND",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    CANCELLED = "CANCELLED"
+}
+/**
+ * File Filters
+ */
+interface FileFilters {
+    type?: FileType;
+    category?: FileCategory;
+    startDate?: number;
+    endDate?: number;
+    minSize?: number;
+    maxSize?: number;
+    tags?: string[];
+}
+/**
+ * File Query Result
+ */
+interface FileQueryResult {
+    files: FileMetadata[];
+    totalCount: number;
+    hasMore: boolean;
+    lastDocId?: string;
+}
+/**
+ * Storage Statistics
+ */
+interface StorageStats {
+    totalFiles: number;
+    totalSize: number;
+    filesByType: Record<FileType, number>;
+    filesByCategory: Record<FileCategory, number>;
+    lastUploadAt?: number;
+}
+
+/**
+ * File Repository Interface
+ * @description Defines contract for file storage operations
+ */
+
+/**
+ * File Repository Interface
+ * Defines operations for file storage and management
+ */
+interface IFileRepository {
+    /**
+     * Upload file to storage
+     */
+    uploadFile(userId: string, path: string, file: File | Blob, options?: UploadOptions): Promise<UploadResult>;
+    /**
+     * Upload image with automatic categorization
+     */
+    uploadImage(userId: string, file: File, filename?: string): Promise<UploadResult>;
+    /**
+     * Upload video with automatic categorization
+     */
+    uploadVideo(userId: string, file: File, filename?: string): Promise<UploadResult>;
+    /**
+     * Upload document with automatic categorization
+     */
+    uploadDocument(userId: string, file: File, filename?: string): Promise<UploadResult>;
+    /**
+     * Upload profile picture
+     */
+    uploadProfilePicture(userId: string, file: File): Promise<UploadResult>;
+    /**
+     * Get download URL for a file
+     */
+    getDownloadURL(path: string): Promise<string>;
+    /**
+     * Delete file by path
+     */
+    deleteFile(path: string): Promise<void>;
+    /**
+     * Delete all user files
+     */
+    deleteUserFiles(userId: string): Promise<void>;
+    /**
+     * Delete user image
+     */
+    deleteImage(userId: string, filename: string): Promise<void>;
+    /**
+     * Delete user video
+     */
+    deleteVideo(userId: string, filename: string): Promise<void>;
+    /**
+     * Delete profile picture
+     */
+    deleteProfilePicture(userId: string, filename: string): Promise<void>;
+    /**
+     * List user files
+     */
+    listUserFiles(userId: string, path?: string): Promise<string[]>;
+    /**
+     * List user images
+     */
+    listUserImages(userId: string): Promise<string[]>;
+    /**
+     * List user videos
+     */
+    listUserVideos(userId: string): Promise<string[]>;
+    /**
+     * Get file metadata
+     */
+    getFileMetadata(path: string): Promise<FileMetadata>;
+    /**
+     * Query files with filters
+     */
+    queryFiles(userId: string, filters?: FileFilters): Promise<FileQueryResult>;
+    /**
+     * Get storage statistics
+     */
+    getStorageStats(userId: string): Promise<StorageStats>;
+    /**
+     * Validate file before upload
+     */
+    validateFile(file: File, options?: {
+        maxSizeBytes?: number;
+        maxSizeMB?: number;
+        allowedTypes?: string[];
+    }): boolean;
+    /**
+     * Check if file is an image
+     */
+    isImageFile(file: File): boolean;
+    /**
+     * Check if file is a video
+     */
+    isVideoFile(file: File): boolean;
+    /**
+     * Check if file is a document
+     */
+    isDocumentFile(file: File): boolean;
+    /**
+     * Generate unique filename
+     */
+    generateUniqueFilename(originalName: string): string;
+    /**
+     * Get file extension
+     */
+    getFileExtension(filename: string): string;
+}
+
+export { type FileCategory as F, type IFileRepository as I, type StorageStats as S, type UploadOptions as U, type ValidationResult as V, FileErrorCode as a, type FileFilters as b, type FileMetadata as c, type FileQueryResult as d, type FileType as e, type FileUploadResult as f, type FileValidationOptions as g, type UploadProgress as h, type UploadResult as i, type UploadState as j };

package/dist/firebase.entity-xvfEPjXZ.d.mts

@@ -0,0 +1,15 @@
+/**
+ * Firebase Entity Types
+ */
+type FirebaseTimestamp = {
+    toDate(): Date;
+} | Date;
+interface FirebaseUser {
+    uid: string;
+    email: string | null;
+    displayName: string | null;
+    photoURL: string | null;
+    emailVerified: boolean;
+}
+
+export type { FirebaseTimestamp as F, FirebaseUser as a };

package/dist/firebase.entity-xvfEPjXZ.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Firebase Entity Types
+ */
+type FirebaseTimestamp = {
+    toDate(): Date;
+} | Date;
+interface FirebaseUser {
+    uid: string;
+    email: string | null;
+    displayName: string | null;
+    photoURL: string | null;
+    emailVerified: boolean;
+}
+
+export type { FirebaseTimestamp as F, FirebaseUser as a };

package/dist/index.d.mts

@@ -1,96 +1,14 @@
-import { FirebaseApp, FirebaseOptions } from 'firebase/app';
-import { Auth, UserCredential } from 'firebase/auth';
-import { Firestore, DocumentData, CollectionReference, QueryConstraint } from 'firebase/firestore';
-import { FirebaseStorage } from 'firebase/storage';
-import { Functions } from 'firebase/functions';
-import * as _firebase_firestore from '@firebase/firestore';
-
-/**
- * Firebase Entity Types
- */
-type FirebaseTimestamp = {
-    toDate(): Date;
-} | Date;
-interface FirebaseUser {
-    uid: string;
-    email: string | null;
-    displayName: string | null;
-    photoURL: string | null;
-    emailVerified: boolean;
-}
-
-/**
- * Base Repository Interface
- */
-interface IBaseRepository<T> {
-    getById(id: string, parentPath?: string): Promise<T | null>;
-    getAll(constraints?: any[], parentPath?: string): Promise<T[]>;
-    create(id: string, data: Omit<T, 'id'>, parentPath?: string): Promise<void>;
-    update(id: string, data: Partial<T>, parentPath?: string): Promise<void>;
-    delete(id: string, parentPath?: string): Promise<void>;
-}
-
-/**
- * Firebase Service Infrastructure
- * @description Initialization and instance management for Firebase
- */
-interface FirebaseInstances {
-    app: FirebaseApp;
-    auth: Auth;
-    db: Firestore;
-    storage: FirebaseStorage;
-    functions: Functions;
-}
-declare function initializeFirebase(config: FirebaseOptions, appName?: string): FirebaseInstances;
-
-/**
- * Firestore Repository Implementation
- * @description Generic CRUD operations for Firestore collections
- */
-declare class FirestoreRepository<T extends DocumentData> implements IBaseRepository<T> {
-    protected db: Firestore;
-    protected collectionName: string;
-    constructor(db: Firestore, collectionName: string);
-    protected getCollection(parentPath?: string): CollectionReference<T>;
-    protected getDocRef(id: string, parentPath?: string): _firebase_firestore.DocumentReference<DocumentData, DocumentData>;
-    getById(id: string, parentPath?: string): Promise<T | null>;
-    getAll(constraints?: QueryConstraint[], parentPath?: string): Promise<T[]>;
-    create(id: string, data: Omit<T, 'id'>, parentPath?: string): Promise<void>;
-    update(id: string, data: Partial<T>, parentPath?: string): Promise<void>;
-    delete(id: string, parentPath?: string): Promise<void>;
-}
-
-/**
- * Firebase Storage Utils
- * @description Upload and delete helpers for Firebase Storage
- */
-interface UploadResult {
-    url: string;
-    path: string;
-}
-declare function uploadFile(storage: FirebaseStorage, path: string, file: File | Blob): Promise<UploadResult>;
-declare function uploadBase64(storage: FirebaseStorage, path: string, base64: string, mimeType?: string): Promise<UploadResult>;
-declare function deleteFile(storage: FirebaseStorage, path: string): Promise<void>;
-
-/**
- * useFirebaseAuth Hook
- * @description Hook to manage Firebase authentication state and operations
- */
-interface UseFirebaseAuthOptions {
-    onUserChange?: (user: FirebaseUser | null) => void;
-}
-interface UseFirebaseAuthReturn {
-    user: FirebaseUser | null;
-    loading: boolean;
-    isAuthenticated: boolean;
-    signIn(email: string, password: string): Promise<UserCredential>;
-    signUp(email: string, password: string, name?: string): Promise<UserCredential>;
-    signOut(): Promise<void>;
-    updateUserProfile(name: string, photoURL?: string): Promise<void>;
-    updateUserPassword(newPassword: string): Promise<void>;
-    resetPassword(email: string): Promise<void>;
-    getIdToken(): Promise<string>;
-}
-declare function useFirebaseAuth(auth: Auth, options?: UseFirebaseAuthOptions): UseFirebaseAuthReturn;
-
-export { type FirebaseInstances, type FirebaseTimestamp, type FirebaseUser, FirestoreRepository, type IBaseRepository, type UploadResult, type UseFirebaseAuthOptions, type UseFirebaseAuthReturn, deleteFile, initializeFirebase, uploadBase64, uploadFile, useFirebaseAuth };
+export { F as FirebaseTimestamp, a as FirebaseUser } from './firebase.entity-xvfEPjXZ.mjs';
+export { A as AccountMetrics, I as IAuthRepository, a as IUserRepository, P as PlatformBreakdown, U as USER_COLLECTIONS, b as USER_SUBCOLLECTIONS, c as User, d as UserAnalytics, e as UserConnectedAccount, f as UserContent, g as UserCredits, h as UserNotifications, i as UserPrivacy, j as UserProfile, k as UserSettings, l as UserSubscription } from './user.repository.interface-DS74TsJ5.mjs';
+export { F as FileCategory, a as FileErrorCode, b as FileFilters, c as FileMetadata, d as FileQueryResult, e as FileType, f as FileUploadResult, g as FileValidationOptions, I as IFileRepository, S as StorageStats, U as UploadOptions, h as UploadProgress, i as UploadResult, j as UploadState, V as ValidationResult } from './file.repository.interface-v5vHgVsZ.mjs';
+export { AuthError, AuthErrorCode, Email, FilePath, IBaseRepository, RepositoryError, RepositoryErrorCode, ServerTimestamp, Timestamp, TimestampField, UserId, createAuthError, createRepositoryError, serverTimestamp } from './domain/index.mjs';
+export { CreateUserDTO, DeleteAccountDTO, DeleteAccountUseCase, ResetPasswordDTO, ResetPasswordUseCase, SignInDTO, SignInUseCase, SignInWithGoogleUseCase, SignOutUseCase, SignUpDTO, SignUpResult, SignUpUseCase, UpdateEmailDTO, UpdatePasswordDTO, UpdateProfileDTO, UpdateProfileUseCase, UpdateUserDTO, UpdateUserSettingsDTO, UpdateUserSubscriptionDTO, UserQueryResult } from './application/index.mjs';
+export { AuthAdapter, FirebaseInstances, FirestoreAdapter, StorageAdapter, StorageUploadResult, analytics, app, auth, db, deleteFile, functions, getFirebaseAnalytics, getFirebaseApp, getFirebaseAuth, getFirebaseDB, getFirebaseFunctions, getFirebaseInstances, getFirebaseStorage, initializeFirebase, storage, uploadBase64, uploadFile } from './infrastructure/index.mjs';
+export { UseFirebaseAuthOptions, UseFirebaseAuthReturn, useFirebaseAuth } from './presentation/index.mjs';
+import 'firebase/auth';
+import 'firebase/firestore';
+import 'firebase/app';
+import 'firebase/storage';
+import 'firebase/analytics';
+import 'firebase/functions';
+import '@firebase/util';