@umituz/react-native-firebase 1.13.17 → 1.13.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-firebase",
-  "version": "1.13.17",
+  "version": "1.13.19",
   "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

@@ -108,6 +108,12 @@ export {
   getQuotaErrorMessage,
 } from './utils/quota-error-detector.util';
 
+// =============================================================================
+// UTILS - Path Resolver
+// =============================================================================
+
+export { FirestorePathResolver } from './utils/path-resolver';
+
 // =============================================================================
 // DOMAIN LAYER - Constants
 // =============================================================================

package/src/firestore/utils/path-resolver.ts

@@ -0,0 +1,41 @@
+import type { Firestore } from "firebase/firestore";
+import { collection, doc } from "firebase/firestore";
+
+/**
+ * Resolves Firestore paths for user collections
+ * Standard pattern: users/{userId}/{collectionName}
+ * 
+ * This class is designed to be used across hundreds of apps.
+ * All user data MUST be under users/{userId}/ for consistency.
+ */
+export class FirestorePathResolver {
+    constructor(
+        private readonly collectionName: string,
+        private readonly db: Firestore | null,
+    ) { }
+
+    /**
+     * Get collection reference for a user
+     * Pattern: users/{userId}/{collectionName}
+     * 
+     * @param userId User identifier
+     * @returns CollectionReference or null if db not initialized
+     */
+    getUserCollection(userId: string) {
+        if (!this.db) return null;
+        return collection(this.db, "users", userId, this.collectionName);
+    }
+
+    /**
+     * Get document reference for a specific item
+     * Pattern: users/{userId}/{collectionName}/{documentId}
+     * 
+     * @param userId User identifier
+     * @param documentId Document identifier
+     * @returns DocumentReference or null if db not initialized
+     */
+    getDocRef(userId: string, documentId: string) {
+        if (!this.db) return null;
+        return doc(this.db, "users", userId, this.collectionName, documentId);
+    }
+}