@umituz/react-native-firebase 1.13.22 → 1.13.23

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-firebase",
-  "version": "1.13.22",
+  "version": "1.13.23",
   "description": "Unified Firebase package for React Native apps - Auth and Firestore services using Firebase JS SDK (no native modules).",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/firestore/domain/entities/QuotaMetrics.ts

@@ -0,0 +1,26 @@
+/**
+ * Quota Metrics Types
+ */
+
+export interface QuotaMetrics {
+    readCount: number;
+    writeCount: number;
+    deleteCount: number;
+    lastResetDate: string;
+}
+
+export interface QuotaLimits {
+    dailyReadLimit: number;
+    dailyWriteLimit: number;
+    dailyDeleteLimit: number;
+}
+
+export interface QuotaStatus {
+    metrics: QuotaMetrics;
+    limits: QuotaLimits;
+    readPercentage: number;
+    writePercentage: number;
+    deletePercentage: number;
+    isNearLimit: boolean;
+    isOverLimit: boolean;
+}

package/src/firestore/domain/entities/RequestLog.ts

@@ -0,0 +1,28 @@
+/**
+ * Request Log Types
+ */
+
+export type RequestType = 'read' | 'write' | 'delete' | 'listener';
+
+export interface RequestLog {
+    id: string;
+    type: RequestType;
+    collection: string;
+    documentId?: string;
+    cached: boolean;
+    success: boolean;
+    error?: string;
+    duration?: number;
+    timestamp: number;
+}
+
+export interface RequestStats {
+    totalRequests: number;
+    readRequests: number;
+    writeRequests: number;
+    deleteRequests: number;
+    listenerRequests: number;
+    cachedRequests: number;
+    failedRequests: number;
+    averageDuration: number;
+}

package/src/firestore/index.ts

@@ -1,17 +1,6 @@
 /**
  * React Native Firestore Module
  * Domain-Driven Design (DDD) Architecture
- *
- * This is the SINGLE SOURCE OF TRUTH for all Firestore operations.
- * ALL imports from the Firestore module MUST go through this file.
- *
- * Architecture:
- * - domain: Errors, Constants, Entities, Services
- * - infrastructure: Firestore client, BaseRepository, utilities
- * - utils: Date utilities, timestamp conversion, query builders
- *
- * This module is designed to be used across hundreds of apps.
- * It provides a consistent interface for Firestore operations.
  */
 
 // =============================================================================
@@ -98,16 +87,6 @@ export {
   createDocumentMapper,
 } from './utils/document-mapper.helper';
 
-// =============================================================================
-// UTILS - Quota Error Detection
-// =============================================================================
-
-export {
-  isQuotaError,
-  isRetryableError,
-  getQuotaErrorMessage,
-} from './utils/quota-error-detector.util';
-
 // =============================================================================
 // UTILS - Path Resolver
 // =============================================================================
@@ -148,6 +127,16 @@ export type {
 
 export { QuotaCalculator } from './domain/services/QuotaCalculator';
 
+// =============================================================================
+// UTILS - Quota Error Detection
+// =============================================================================
+
+export {
+  isQuotaError,
+  isRetryableError,
+  getQuotaErrorMessage,
+} from './utils/quota-error-detector.util';
+
 // =============================================================================
 // INFRASTRUCTURE LAYER - Middleware
 // =============================================================================
@@ -166,11 +155,6 @@ export {
 // INFRASTRUCTURE LAYER - Services
 // =============================================================================
 
-export {
-  QuotaMonitorService,
-  quotaMonitorService,
-} from './infrastructure/services/QuotaMonitorService';
-
 export {
   RequestLoggerService,
   requestLoggerService,

package/src/firestore/infrastructure/middleware/QuotaTrackingMiddleware.ts

@@ -0,0 +1,103 @@
+/**
+ * Quota Tracking Middleware
+ * Tracks Firestore operations for quota monitoring
+ */
+
+declare const __DEV__: boolean;
+
+interface OperationInfo {
+    type: 'read' | 'write' | 'delete';
+    collection: string;
+    count: number;
+    cached: boolean;
+}
+
+export class QuotaTrackingMiddleware {
+    private readCount = 0;
+    private writeCount = 0;
+    private deleteCount = 0;
+
+    /**
+     * Track a Firestore operation
+     */
+    async trackOperation<T>(
+        info: OperationInfo,
+        operation: () => Promise<T>
+    ): Promise<T> {
+        const result = await operation();
+
+        switch (info.type) {
+            case 'read':
+                if (!info.cached) {
+                    this.readCount += info.count;
+                }
+                break;
+            case 'write':
+                this.writeCount += info.count;
+                break;
+            case 'delete':
+                this.deleteCount += info.count;
+                break;
+        }
+
+        if (__DEV__) {
+            console.log(`[QuotaTracking] ${info.type}: ${info.collection} (${info.count})`);
+        }
+
+        return result;
+    }
+
+    /**
+     * Track read operation
+     */
+    trackRead(collection: string, count: number = 1, cached: boolean = false): void {
+        if (!cached) {
+            this.readCount += count;
+        }
+        if (__DEV__) {
+            console.log(`[QuotaTracking] read: ${collection} (${count})`);
+        }
+    }
+
+    /**
+     * Track write operation
+     */
+    trackWrite(collection: string, _documentId?: string, count: number = 1): void {
+        this.writeCount += count;
+        if (__DEV__) {
+            console.log(`[QuotaTracking] write: ${collection} (${count})`);
+        }
+    }
+
+    /**
+     * Track delete operation
+     */
+    trackDelete(collection: string, _documentId?: string, count: number = 1): void {
+        this.deleteCount += count;
+        if (__DEV__) {
+            console.log(`[QuotaTracking] delete: ${collection} (${count})`);
+        }
+    }
+
+    /**
+     * Get current counts
+     */
+    getCounts(): { reads: number; writes: number; deletes: number } {
+        return {
+            reads: this.readCount,
+            writes: this.writeCount,
+            deletes: this.deleteCount,
+        };
+    }
+
+    /**
+     * Reset counts
+     */
+    reset(): void {
+        this.readCount = 0;
+        this.writeCount = 0;
+        this.deleteCount = 0;
+    }
+}
+
+export const quotaTrackingMiddleware = new QuotaTrackingMiddleware();

package/src/firestore/utils/quota-error-detector.util.ts

@@ -0,0 +1,59 @@
+/**
+ * Quota Error Detection Utilities
+ */
+
+const QUOTA_ERROR_CODES = [
+    'resource-exhausted',
+    'quota-exceeded',
+    'RESOURCE_EXHAUSTED',
+];
+
+const QUOTA_ERROR_MESSAGES = [
+    'quota',
+    'exceeded',
+    'limit',
+    'too many requests',
+];
+
+/**
+ * Check if error is a Firestore quota error
+ */
+export function isQuotaError(error: unknown): boolean {
+    if (!error) return false;
+
+    const errorObj = error as Record<string, unknown>;
+    const code = errorObj.code as string | undefined;
+    const message = errorObj.message as string | undefined;
+
+    if (code && QUOTA_ERROR_CODES.some((c) => code.includes(c))) {
+        return true;
+    }
+
+    if (message) {
+        const lowerMessage = message.toLowerCase();
+        return QUOTA_ERROR_MESSAGES.some((m) => lowerMessage.includes(m));
+    }
+
+    return false;
+}
+
+/**
+ * Check if error is retryable
+ */
+export function isRetryableError(error: unknown): boolean {
+    if (!error) return false;
+
+    const errorObj = error as Record<string, unknown>;
+    const code = errorObj.code as string | undefined;
+
+    const retryableCodes = ['unavailable', 'deadline-exceeded', 'aborted'];
+
+    return code ? retryableCodes.some((c) => code.includes(c)) : false;
+}
+
+/**
+ * Get user-friendly quota error message
+ */
+export function getQuotaErrorMessage(): string {
+    return 'Daily quota exceeded. Please try again tomorrow or upgrade your plan.';
+}