@umituz/react-native-firebase 1.13.49 → 1.13.50

package/scripts/firestore.ts

@@ -3,278 +3,23 @@
  * Generic Firestore operations for admin scripts
  */
 
-import * as admin from "firebase-admin";
-import type { CollectionInfo, BatchResult } from "./types";
-
-const BATCH_SIZE = 500;
-
-/**
- * List all root-level collections
- */
-export async function listCollections(
-  db: admin.firestore.Firestore
-): Promise<CollectionInfo[]> {
-  const collections = await db.listCollections();
-  const result: CollectionInfo[] = [];
-
-  for (const collection of collections) {
-    const snapshot = await collection.limit(1000).get();
-    const info: CollectionInfo = {
-      name: collection.id,
-      documentCount: snapshot.docs.length,
-      sampleDocumentId: snapshot.docs[0]?.id,
-    };
-
-    if (!snapshot.empty) {
-      const subcollections = await snapshot.docs[0].ref.listCollections();
-      info.hasSubcollections = subcollections.length > 0;
-    }
-
-    result.push(info);
-  }
-
-  return result.sort((a, b) => b.documentCount - a.documentCount);
-}
-
-/**
- * List subcollections for a user document
- */
-export async function listUserSubcollections(
-  db: admin.firestore.Firestore,
-  userId: string
-): Promise<CollectionInfo[]> {
-  const userRef = db.collection("users").doc(userId);
-  const subcollections = await userRef.listCollections();
-  const result: CollectionInfo[] = [];
-
-  for (const subcollection of subcollections) {
-    const count = await subcollection.count().get();
-    result.push({
-      name: subcollection.id,
-      documentCount: count.data().count,
-    });
-  }
-
-  return result;
-}
-
-/**
- * Delete collection in batches
- */
-export async function deleteCollection(
-  db: admin.firestore.Firestore,
-  collectionPath: string,
-  onProgress?: (deleted: number) => void
-): Promise<number> {
-  let totalDeleted = 0;
-  let hasMore = true;
-
-  while (hasMore) {
-    const snapshot = await db
-      .collection(collectionPath)
-      .orderBy("__name__")
-      .limit(BATCH_SIZE)
-      .get();
-
-    if (snapshot.empty) {
-      hasMore = false;
-      continue;
-    }
-
-    const batch = db.batch();
-    snapshot.docs.forEach((doc) => batch.delete(doc.ref));
-    await batch.commit();
-
-    totalDeleted += snapshot.docs.length;
-    onProgress?.(totalDeleted);
-  }
-
-  return totalDeleted;
-}
-
-/**
- * Delete user subcollection for all users
- */
-export async function deleteUserSubcollection(
-  db: admin.firestore.Firestore,
-  subcollectionName: string,
-  onProgress?: (deleted: number) => void
-): Promise<number> {
-  let totalDeleted = 0;
-  const usersSnapshot = await db.collection("users").get();
-
-  for (const userDoc of usersSnapshot.docs) {
-    const subcollectionRef = userDoc.ref.collection(subcollectionName);
-    const subcollectionSnapshot = await subcollectionRef.get();
-
-    if (!subcollectionSnapshot.empty) {
-      const batch = db.batch();
-      subcollectionSnapshot.docs.forEach((doc) => batch.delete(doc.ref));
-      await batch.commit();
-      totalDeleted += subcollectionSnapshot.docs.length;
-      onProgress?.(totalDeleted);
-    }
-  }
-
-  return totalDeleted;
-}
-
-/**
- * Delete all Firestore data
- */
-export async function deleteAllData(
-  db: admin.firestore.Firestore,
-  onProgress?: (collection: string, deleted: number) => void
-): Promise<number> {
-  let totalDeleted = 0;
-  const collections = await db.listCollections();
-
-  for (const collection of collections) {
-    const snapshot = await collection.get();
-
-    // Delete subcollections first for users collection
-    if (collection.id === "users") {
-      for (const doc of snapshot.docs) {
-        const subcollections = await doc.ref.listCollections();
-        for (const subcollection of subcollections) {
-          const subSnapshot = await subcollection.get();
-          if (!subSnapshot.empty) {
-            const batch = db.batch();
-            subSnapshot.docs.forEach((subDoc) => batch.delete(subDoc.ref));
-            await batch.commit();
-            totalDeleted += subSnapshot.docs.length;
-          }
-        }
-      }
-    }
-
-    // Delete main collection documents
-    if (!snapshot.empty) {
-      const batch = db.batch();
-      snapshot.docs.forEach((doc) => batch.delete(doc.ref));
-      await batch.commit();
-      totalDeleted += snapshot.docs.length;
-      onProgress?.(collection.id, totalDeleted);
-    }
-  }
-
-  return totalDeleted;
-}
-
-/**
- * Seed documents in batches
- */
-export async function seedBatch(
-  db: admin.firestore.Firestore,
-  collectionPath: string,
-  docs: Array<{ id: string; data: Record<string, unknown> }>
-): Promise<BatchResult> {
-  const result: BatchResult = {
-    success: true,
-    processed: 0,
-    errors: [],
-  };
-
-  for (let i = 0; i < docs.length; i += BATCH_SIZE) {
-    const batch = db.batch();
-    const slice = docs.slice(i, i + BATCH_SIZE);
-
-    for (const { id, data } of slice) {
-      const ref = db.collection(collectionPath).doc(id);
-      const clean = Object.fromEntries(
-        Object.entries(data).filter(([, v]) => v !== undefined)
-      );
-      batch.set(ref, clean);
-    }
-
-    try {
-      await batch.commit();
-      result.processed += slice.length;
-    } catch (error) {
-      result.success = false;
-      result.errors.push(`Batch failed at index ${i}: ${error}`);
-    }
-  }
-
-  return result;
-}
-
-/**
- * Seed user subcollection
- */
-export async function seedUserSubcollection(
-  db: admin.firestore.Firestore,
-  userId: string,
-  subcollectionName: string,
-  docs: Array<{ id: string; data: Record<string, unknown> }>
-): Promise<BatchResult> {
-  const result: BatchResult = {
-    success: true,
-    processed: 0,
-    errors: [],
-  };
-
-  const batch = db.batch();
-
-  for (const { id, data } of docs) {
-    const ref = db
-      .collection("users")
-      .doc(userId)
-      .collection(subcollectionName)
-      .doc(id);
-    const clean = Object.fromEntries(
-      Object.entries(data).filter(([, v]) => v !== undefined)
-    );
-    batch.set(ref, clean);
-  }
-
-  try {
-    await batch.commit();
-    result.processed = docs.length;
-  } catch (error) {
-    result.success = false;
-    result.errors.push(`Failed to seed subcollection: ${error}`);
-  }
-
-  return result;
-}
-
-/**
- * Count documents in collection
- */
-export async function countDocuments(
-  db: admin.firestore.Firestore,
-  collectionPath: string
-): Promise<number> {
-  const count = await db.collection(collectionPath).count().get();
-  return count.data().count;
-}
-
-/**
- * Get user document count statistics
- */
-export async function getUserStats(db: admin.firestore.Firestore): Promise<{
-  total: number;
-  anonymous: number;
-  authenticated: number;
-}> {
-  const usersSnapshot = await db.collection("users").get();
-
-  let anonymous = 0;
-  let authenticated = 0;
-
-  usersSnapshot.docs.forEach((doc) => {
-    const data = doc.data();
-    if (data.isAnonymous) {
-      anonymous++;
-    } else {
-      authenticated++;
-    }
-  });
-
-  return {
-    total: usersSnapshot.docs.length,
-    anonymous,
-    authenticated,
-  };
-}
+// Query functions
+export {
+  listCollections,
+  listUserSubcollections,
+  countDocuments,
+  getUserStats,
+} from "./firestore-queries";
+
+// Delete operations
+export {
+  deleteCollection,
+  deleteUserSubcollection,
+  deleteAllData,
+} from "./firestore-operations";
+
+// Seed operations
+export {
+  seedBatch,
+  seedUserSubcollection,
+} from "./firestore-seeding";

package/scripts/user-commands.ts

@@ -0,0 +1,104 @@
+/**
+ * Firebase Admin User Commands
+ * Command functions for modifying user data
+ */
+
+import * as admin from "firebase-admin";
+import type { UserCredits, CreditsConfig } from "./types";
+
+/**
+ * Initialize credits for a user
+ */
+export async function initializeUserCredits(
+  db: admin.firestore.Firestore,
+  userId: string,
+  config: CreditsConfig
+): Promise<UserCredits> {
+  const { collectionName = "user_credits", textLimit = 0, imageLimit = 0 } = config;
+
+  const now = admin.firestore.FieldValue.serverTimestamp();
+
+  const credits: Omit<UserCredits, "createdAt" | "updatedAt"> & {
+    createdAt: admin.firestore.FieldValue;
+    updatedAt: admin.firestore.FieldValue;
+  } = {
+    text: textLimit,
+    image: imageLimit,
+    video: 0,
+    audio: 0,
+    createdAt: now,
+    updatedAt: now,
+  };
+
+  await db.collection(collectionName).doc(userId).set(credits, { merge: true });
+
+  return {
+    text: textLimit,
+    image: imageLimit,
+    video: 0,
+    audio: 0,
+    createdAt: new Date(),
+    updatedAt: new Date(),
+  };
+}
+
+/**
+ * Add credits to a user
+ */
+export async function addUserCredits(
+  db: admin.firestore.Firestore,
+  userId: string,
+  credits: { text?: number; image?: number; video?: number; audio?: number },
+  collectionName = "user_credits"
+): Promise<void> {
+  const updates: Record<string, admin.firestore.FieldValue> = {
+    updatedAt: admin.firestore.FieldValue.serverTimestamp(),
+  };
+
+  if (credits.text) {
+    updates.text = admin.firestore.FieldValue.increment(credits.text);
+  }
+  if (credits.image) {
+    updates.image = admin.firestore.FieldValue.increment(credits.image);
+  }
+  if (credits.video) {
+    updates.video = admin.firestore.FieldValue.increment(credits.video);
+  }
+  if (credits.audio) {
+    updates.audio = admin.firestore.FieldValue.increment(credits.audio);
+  }
+
+  await db.collection(collectionName).doc(userId).update(updates);
+}
+
+/**
+ * Set credits for a user (overwrite)
+ */
+export async function setUserCredits(
+  db: admin.firestore.Firestore,
+  userId: string,
+  credits: { text?: number; image?: number; video?: number; audio?: number },
+  collectionName = "user_credits"
+): Promise<void> {
+  const updates: Record<string, unknown> = {
+    updatedAt: admin.firestore.FieldValue.serverTimestamp(),
+  };
+
+  if (credits.text !== undefined) updates.text = credits.text;
+  if (credits.image !== undefined) updates.image = credits.image;
+  if (credits.video !== undefined) updates.video = credits.video;
+  if (credits.audio !== undefined) updates.audio = credits.audio;
+
+  await db.collection(collectionName).doc(userId).set(updates, { merge: true });
+}
+
+/**
+ * Delete user credits document
+ */
+export async function deleteUserCredits(
+  db: admin.firestore.Firestore,
+  userId: string,
+  collectionName = "user_credits"
+): Promise<void> {
+  await db.collection(collectionName).doc(userId).delete();
+}

package/scripts/user-formatters.ts

@@ -0,0 +1,55 @@
+/**
+ * Firebase Admin User Formatters
+ * Format functions for displaying user data
+ */
+
+import type { UserData } from "./types";
+
+/**
+ * Print user data in formatted way
+ */
+export function printUserData(data: UserData): void {
+  console.log("\n" + "═".repeat(60));
+  console.log(`👤 USER: ${data.userId}`);
+  console.log("═".repeat(60));
+
+  console.log("\n📋 PROFILE:");
+  if (data.profile) {
+    console.log(JSON.stringify(data.profile, null, 2));
+  } else {
+    console.log("  ❌ Not found");
+  }
+
+  console.log("\n💰 CREDITS:");
+  if (data.credits) {
+    console.log(`  Text:  ${data.credits.text || 0}`);
+    console.log(`  Image: ${data.credits.image || 0}`);
+    console.log(`  Video: ${data.credits.video || 0}`);
+    console.log(`  Audio: ${data.credits.audio || 0}`);
+  } else {
+    console.log("  ❌ Not found");
+  }
+
+  console.log("\n🔔 SUBSCRIPTIONS:");
+  if (data.subscriptions.length > 0) {
+    data.subscriptions.forEach((sub) => {
+      console.log(`  - ${sub.id}: ${JSON.stringify(sub)}`);
+    });
+  } else {
+    console.log("  ❌ None");
+  }
+
+  console.log("\n🧾 TRANSACTIONS:");
+  if (data.transactions.length > 0) {
+    data.transactions.slice(0, 5).forEach((tx) => {
+      console.log(`  - ${tx.id}: ${JSON.stringify(tx)}`);
+    });
+    if (data.transactions.length > 5) {
+      console.log(`  ... and ${data.transactions.length - 5} more`);
+    }
+  } else {
+    console.log("  ❌ None");
+  }
+
+  console.log("\n" + "═".repeat(60) + "\n");
+}

package/scripts/user-queries.ts

@@ -0,0 +1,185 @@
+/**
+ * Firebase Admin User Queries
+ * Query functions for reading user data
+ */
+
+import * as admin from "firebase-admin";
+import type { UserData, UserCredits } from "./types";
+
+/**
+ * Get complete user data including profile and all related collections
+ */
+export async function getUserData(
+  db: admin.firestore.Firestore,
+  userId: string,
+  options?: {
+    includeCredits?: boolean;
+    includeSubscriptions?: boolean;
+    includeTransactions?: boolean;
+    creditsCollection?: string;
+  }
+): Promise<UserData> {
+  const {
+    includeCredits = true,
+    includeSubscriptions = true,
+    includeTransactions = true,
+    creditsCollection = "user_credits",
+  } = options || {};
+
+  const result: UserData = {
+    userId,
+    exists: false,
+    profile: null,
+    credits: null,
+    subscriptions: [],
+    transactions: [],
+  };
+
+  // Get user profile
+  const userDoc = await db.collection("users").doc(userId).get();
+  if (userDoc.exists) {
+    result.exists = true;
+    result.profile = userDoc.data() as Record<string, unknown>;
+  }
+
+  // Get credits from root-level collection
+  if (includeCredits) {
+    const creditsDoc = await db.collection(creditsCollection).doc(userId).get();
+    if (creditsDoc.exists) {
+      result.credits = creditsDoc.data() as UserCredits;
+    }
+  }
+
+  // Get subscriptions subcollection
+  if (includeSubscriptions) {
+    const subsSnapshot = await db
+      .collection("users")
+      .doc(userId)
+      .collection("subscriptions")
+      .get();
+    result.subscriptions = subsSnapshot.docs.map((doc) => ({
+      id: doc.id,
+      ...doc.data(),
+    }));
+  }
+
+  // Get transactions subcollection
+  if (includeTransactions) {
+    const txSnapshot = await db
+      .collection("users")
+      .doc(userId)
+      .collection("transactions")
+      .orderBy("createdAt", "desc")
+      .limit(50)
+      .get();
+    result.transactions = txSnapshot.docs.map((doc) => ({
+      id: doc.id,
+      ...doc.data(),
+    }));
+  }
+
+  return result;
+}
+
+/**
+ * List all users with their credit balances
+ */
+export async function listUsersWithCredits(
+  db: admin.firestore.Firestore,
+  options?: {
+    creditsCollection?: string;
+    limit?: number;
+    onlyWithCredits?: boolean;
+  }
+): Promise<
+  Array<{
+    userId: string;
+    displayName?: string;
+    email?: string;
+    isAnonymous: boolean;
+    credits: UserCredits | null;
+  }>
+> {
+  const { creditsCollection = "user_credits", limit = 100, onlyWithCredits = false } = options || {};
+
+  const usersSnapshot = await db.collection("users").limit(limit).get();
+  const result: Array<{
+    userId: string;
+    displayName?: string;
+    email?: string;
+    isAnonymous: boolean;
+    credits: UserCredits | null;
+  }> = [];
+
+  for (const userDoc of usersSnapshot.docs) {
+    const userData = userDoc.data();
+    const creditsDoc = await db.collection(creditsCollection).doc(userDoc.id).get();
+    const credits = creditsDoc.exists ? (creditsDoc.data() as UserCredits) : null;
+
+    if (onlyWithCredits && !credits) continue;
+
+    result.push({
+      userId: userDoc.id,
+      displayName: userData.displayName,
+      email: userData.email,
+      isAnonymous: userData.isAnonymous || false,
+      credits,
+    });
+  }
+
+  return result;
+}
+
+/**
+ * Get credits summary across all users
+ */
+export async function getCreditsSummary(
+  db: admin.firestore.Firestore,
+  collectionName = "user_credits"
+): Promise<{
+  totalUsers: number;
+  totalText: number;
+  totalImage: number;
+  totalVideo: number;
+  totalAudio: number;
+  usersWithCredits: number;
+  usersWithZeroCredits: number;
+}> {
+  const snapshot = await db.collection(collectionName).get();
+
+  let totalText = 0;
+  let totalImage = 0;
+  let totalVideo = 0;
+  let totalAudio = 0;
+  let usersWithCredits = 0;
+  let usersWithZeroCredits = 0;
+
+  snapshot.docs.forEach((doc) => {
+    const data = doc.data();
+    const text = data.text || 0;
+    const image = data.image || 0;
+    const video = data.video || 0;
+    const audio = data.audio || 0;
+
+    totalText += text;
+    totalImage += image;
+    totalVideo += video;
+    totalAudio += audio;
+
+    if (text > 0 || image > 0 || video > 0 || audio > 0) {
+      usersWithCredits++;
+    } else {
+      usersWithZeroCredits++;
+    }
+  });
+
+  return {
+    totalUsers: snapshot.docs.length,
+    totalText,
+    totalImage,
+    totalVideo,
+    totalAudio,
+    usersWithCredits,
+    usersWithZeroCredits,
+  };
+}