@umituz/react-native-firebase 2.4.86 → 2.4.88

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-firebase",
-  "version": "2.4.86",
+  "version": "2.4.88",
   "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/domains/firestore/index.ts

@@ -96,6 +96,7 @@ export {
 export {
   QueryDeduplicationMiddleware,
   queryDeduplicationMiddleware,
+  syncDeduplicationWithQuota,
   useDeduplicationWithQuota,
 } from './infrastructure/middleware/QueryDeduplicationMiddleware';
 export type {

package/src/domains/firestore/infrastructure/middleware/QueryDeduplicationMiddleware.ts

@@ -30,9 +30,9 @@ const DEFAULT_CLEANUP_INTERVAL_MS = 15000;       // 15s (was 3s)
  * Quota-based window adjustment thresholds
  */
 const QUOTA_THRESHOLDS = {
-  HIGH_USAGE: 0.80,   // 80% - extend window to 30s
+  HIGH_USAGE: 0.80,   // 80% - extend window to 60s (1 min)
   MEDIUM_USAGE: 0.60, // 60% - extend window to 20s
-  NORMAL: 0.60,       // < 60% - use default 10s
+  NORMAL: 0.50,       // < 50% - use default 10s
 } as const;
 
 /**
@@ -280,15 +280,21 @@ export const queryDeduplicationMiddleware = new QueryDeduplicationMiddleware({
 });
 
 /**
- * Hook to integrate deduplication with quota tracking
+ * Helper function to integrate deduplication with quota tracking
  * Automatically adjusts window based on quota usage
  *
+ * Note: This is NOT a React hook, but a helper function.
+ * Call this from your own hook or effect as needed.
+ *
  * @example
  * ```typescript
- * useDeduplicationWithQuota(queryDeduplicationMiddleware, quotaMiddleware);
+ * // In your own hook or component:
+ * useEffect(() => {
+ *   syncDeduplicationWithQuota(queryDeduplicationMiddleware, quotaMiddleware, quotaLimits);
+ * }, [quotaMiddleware.getCounts().reads]);
  * ```
  */
-export function useDeduplicationWithQuota(
+export function syncDeduplicationWithQuota(
   deduplication: QueryDeduplicationMiddleware,
   quotaMiddleware: { getCounts: () => { reads: number; writes: number; deletes: number } },
   quotaLimits: { dailyReadLimit: number }
@@ -298,3 +304,9 @@ export function useDeduplicationWithQuota(
   const quotaPercentage = counts.reads / quotaLimits.dailyReadLimit;
   deduplication.adjustWindowForQuota(quotaPercentage);
 }
+
+/**
+ * @deprecated Use syncDeduplicationWithQuota instead (not a hook)
+ * This will be removed in a future version
+ */
+export const useDeduplicationWithQuota = syncDeduplicationWithQuota;

package/src/domains/firestore/presentation/hooks/useSmartFirestoreSnapshot.ts

@@ -173,6 +173,8 @@ export function useSmartFirestoreSnapshot<TData>(
    * Handle app state changes (foreground/background)
    */
   useEffect(() => {
+    const timers: ReturnType<typeof setTimeout>[] = [];
+
     const handleAppStateChange = (nextAppState: AppStateStatus) => {
       const isBackgrounded = nextAppState.match(/inactive|background/);
 
@@ -190,12 +192,13 @@ export function useSmartFirestoreSnapshot<TData>(
 
           switch (backgroundStrategy) {
             case 'suspend':
-              // Suspend immediately
-              setTimeout(() => suspendListener(), 0);
+              // Suspend immediately - track timer for cleanup
+              const suspendTimer = setTimeout(() => suspendListener(), 0);
+              timers.push(suspendTimer);
               break;
 
             case 'timeout':
-              // Suspend after timeout
+              // Suspend after timeout - timer stored in state for cleanup
               const timer = setTimeout(() => {
                 suspendListener();
               }, backgroundTimeout);
@@ -215,10 +218,11 @@ export function useSmartFirestoreSnapshot<TData>(
             console.log(`[SmartSnapshot] App entering foreground for query:`, queryKey);
           }
 
-          // Resume listener (with optional delay)
-          setTimeout(() => {
+          // Resume listener (with optional delay) - track timer for cleanup
+          const resumeTimer = setTimeout(() => {
             resumeListener();
           }, resumeDelay);
+          timers.push(resumeTimer);
 
           return { ...prev, isBackgrounded: false, suspendTimer: null };
         }
@@ -231,6 +235,8 @@ export function useSmartFirestoreSnapshot<TData>(
 
     return () => {
       subscription.remove();
+      // Clean up any pending timers
+      timers.forEach(timer => clearTimeout(timer));
     };
   }, [queryKey, backgroundStrategy, backgroundTimeout, resumeDelay, suspendListener, resumeListener]);
 
@@ -343,9 +349,13 @@ export function useSmartListenerControl() {
     return () => subscription.remove();
   }, []);
 
+  // Compute background status once to avoid duplicate regex matching
+  const isBackgrounded = appState.match(/inactive|background/);
+  const isForegrounded = !isBackgrounded;
+
   return {
-    isBackgrounded: appState.match(/inactive|background/),
-    isForegrounded: !appState.match(/inactive|background/),
+    isBackgrounded,
+    isForegrounded,
     appState,
   };
 }

package/.agents/workflows/setup-firebase.md

@@ -1,44 +0,0 @@
----
-description: Sets up or updates the @umituz/react-native-firebase package in a React Native app.
----
-
-# Firebase Infrastructure Setup Skill
-
-When this workflow/skill is invoked, follow these explicit instructions to configure `@umituz/react-native-firebase`.
-
-## Step 1: Check and Update `package.json`
-- Analyze the project's `package.json`.
-- Check if `@umituz/react-native-firebase` exists.
-  - If missing: Install with `npm install @umituz/react-native-firebase`.
-  - If outdated: Update it to the latest version.
-
-## Step 2: Install Peer Dependencies
-Check and install any missing peer dependencies (use `npx expo install` for Expo packages to ensure compatibility):
-- `firebase`
-- `@gorhom/portal`
-- `@tanstack/react-query`
-- `@umituz/react-native-design-system`
-- `expo-apple-authentication`, `expo-auth-session`, `expo-crypto`, `expo-web-browser`
-
-## Step 3: Check Environment Variables
-- Ensure that Firebase credentials (like `FIREBASE_API_KEY`, `FIREBASE_PROJECT_ID`, etc.) are defined in the project's `.env.example` and `.env` files. If they are missing, prompt the user to add them or scaffold the keys.
-
-## Step 4: Setup Initialization Logic
-- Locate the main entry point (e.g. `App.tsx`, `index.js`, or a dedicated config file).
-- Check if Firebase is initialized.
-- If not, import and implement the initialization boilerplate from `@umituz/react-native-firebase`:
-  ```typescript
-  import { autoInitializeFirebase } from '@umituz/react-native-firebase';
-  
-  // Call initialization logic early in the app lifecycle
-  ```
-
-// turbo
-## Step 5: Native Setup (If bare React Native)
-If the project structure indicates an iOS build folder is present, run:
-```bash
-cd ios && pod install
-```
-
-## Step 6: Summary
-Output what was done: the packages that were updated, the environment keys that were checked/added, and the files modified to include initialization logic.