@umituz/react-native-firebase 1.13.100 → 1.13.101

package/package.json

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

@@ -112,5 +112,16 @@ export {
   requestLoggerService,
 } from './infrastructure/services/RequestLoggerService';
 
+// Firestore Helper Utilities
+export {
+  getDb,
+  withFirestore,
+  withFirestoreVoid,
+  withFirestoreBool,
+  createErrorResult,
+  createSuccessResult,
+} from './utils/firestore-helper';
+export type { FirestoreResult, NoDbResult } from './utils/firestore-helper';
+
 // Re-export Firestore types
 export type { Timestamp } from 'firebase/firestore';

package/src/firestore/utils/firestore-helper.ts

@@ -0,0 +1,94 @@
+/**
+ * Firestore Helper - Centralized Firestore access utilities
+ * Provides common patterns for Firestore operations with error handling
+ */
+declare const __DEV__: boolean;
+
+import { getFirestore } from "../infrastructure/config/FirestoreClient";
+import type { Firestore } from "../infrastructure/config/FirestoreClient";
+
+export interface FirestoreResult<T> {
+  success: boolean;
+  data?: T;
+  error?: { message: string; code: string };
+}
+
+export type NoDbResult = FirestoreResult<never>;
+
+const NO_DB_ERROR: NoDbResult = {
+  success: false,
+  error: { message: "No DB", code: "DB_ERR" },
+};
+
+/**
+ * Get Firestore instance with null check
+ */
+export function getDb(): Firestore | null {
+  return getFirestore();
+}
+
+/**
+ * Execute a Firestore operation with automatic null check
+ * Returns error result if db is not available
+ */
+export async function withFirestore<T>(
+  operation: (db: Firestore) => Promise<FirestoreResult<T>>,
+  logTag?: string
+): Promise<FirestoreResult<T>> {
+  const db = getDb();
+  if (!db) {
+    if (__DEV__ && logTag) {
+      console.log(`[${logTag}] No Firestore instance`);
+    }
+    return NO_DB_ERROR as FirestoreResult<T>;
+  }
+  return operation(db);
+}
+
+/**
+ * Execute a Firestore operation that returns void
+ */
+export async function withFirestoreVoid(
+  operation: (db: Firestore) => Promise<void>,
+  logTag?: string
+): Promise<void> {
+  const db = getDb();
+  if (!db) {
+    if (__DEV__ && logTag) {
+      console.log(`[${logTag}] No Firestore instance`);
+    }
+    return;
+  }
+  return operation(db);
+}
+
+/**
+ * Execute a Firestore operation that returns boolean
+ */
+export async function withFirestoreBool(
+  operation: (db: Firestore) => Promise<boolean>,
+  logTag?: string
+): Promise<boolean> {
+  const db = getDb();
+  if (!db) {
+    if (__DEV__ && logTag) {
+      console.log(`[${logTag}] No Firestore instance`);
+    }
+    return false;
+  }
+  return operation(db);
+}
+
+/**
+ * Create a standard error result
+ */
+export function createErrorResult<T>(message: string, code: string): FirestoreResult<T> {
+  return { success: false, error: { message, code } };
+}
+
+/**
+ * Create a standard success result
+ */
+export function createSuccessResult<T>(data?: T): FirestoreResult<T> {
+  return { success: true, data };
+}

package/src/index.ts

@@ -88,6 +88,17 @@ export { FirestorePathResolver } from "./firestore/utils/path-resolver";
 export { PaginationHelper } from "./firestore/utils/pagination.helper";
 export type { Timestamp } from "firebase/firestore";
 
+// Firestore Helper Utilities
+export {
+  getDb,
+  withFirestore,
+  withFirestoreVoid,
+  withFirestoreBool,
+  createErrorResult,
+  createSuccessResult,
+} from "./firestore/utils/firestore-helper";
+export type { FirestoreResult, NoDbResult } from "./firestore/utils/firestore-helper";
+
 // Auth Hooks (commonly used)
 export { useSocialAuth } from "./auth/presentation/hooks/useSocialAuth";
 export type {