@umituz/react-native-ai-generation-content 1.65.12 → 1.66.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-ai-generation-content",
-  "version": "1.65.12",
+  "version": "1.66.2",
   "description": "Provider-agnostic AI generation orchestration for React Native with result preview components",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -70,7 +70,7 @@
     "@typescript-eslint/eslint-plugin": "^8.54.0",
     "@typescript-eslint/parser": "^8.54.0",
     "@umituz/react-native-design-system": "^4.23.79",
-    "@umituz/react-native-firebase": "^1.13.87",
+    "@umituz/react-native-firebase": "^1.13.161",
     "@umituz/react-native-subscription": "^2.27.23",
     "eslint": "^9.39.2",
     "eslint-plugin-react": "^7.37.5",

package/src/domains/creations/domain/utils/creation-display.util.ts

@@ -0,0 +1,67 @@
+/**
+ * Creation Display Utilities
+ * Single Responsibility: UI display helpers (icons, titles, text)
+ */
+
+import type { CreationTypeId } from "../types";
+
+/**
+ * Icon name type for design system
+ */
+export type IconName = "image" | "film" | "mic" | "sparkles" | "color-palette" | "brush";
+
+/**
+ * Get icon name for creation type
+ */
+export function getTypeIcon(type: CreationTypeId): IconName {
+  switch (type) {
+    case "text-to-video":
+    case "image-to-video":
+      return "film";
+    case "style-transfer":
+    case "colorization":
+      return "color-palette";
+    case "ai-brush":
+    case "inpainting":
+      return "brush";
+    default:
+      return "image";
+  }
+}
+
+/**
+ * Get i18n key for creation type
+ */
+export function getTypeTextKey(type: CreationTypeId): string {
+  return `creations.types.${type}`;
+}
+
+/**
+ * Get formatted type text (fallback)
+ */
+export function getTypeText(type: CreationTypeId): string {
+  return type.split("-").map(word =>
+    word.charAt(0).toUpperCase() + word.slice(1)
+  ).join(" ");
+}
+
+/**
+ * Get creation title from prompt or type
+ */
+export function getCreationTitle(
+  prompt?: string,
+  type?: CreationTypeId,
+  maxLength: number = 50
+): string {
+  if (prompt && prompt.length > 0) {
+    return prompt.length > maxLength
+      ? prompt.substring(0, maxLength) + "..."
+      : prompt;
+  }
+
+  if (type) {
+    return getTypeText(type);
+  }
+
+  return "Untitled Creation";
+}

package/src/domains/creations/domain/utils/creation-format.util.ts

@@ -0,0 +1,12 @@
+/**
+ * Creation Format Utilities
+ * Single Responsibility: Text formatting
+ */
+
+/**
+ * Truncate text with ellipsis
+ */
+export function truncateText(text: string, maxLength: number): string {
+  if (text.length <= maxLength) return text;
+  return text.substring(0, maxLength - 3) + "...";
+}

package/src/domains/creations/domain/utils/creation-helpers.ts

@@ -1,140 +1,12 @@
 /**
  * Creation Helpers
- * Utility functions for creation data manipulation
+ * Central export point for creation utility functions
+ * @deprecated Individual utilities split into focused modules for better maintainability
  */
 
-import { generateUUID } from "@umituz/react-native-design-system";
-import type { CreationTypeId } from "../types";
-
-/**
- * Generate a unique creation ID using UUID v4
- */
-export function generateCreationId(): string {
-  return generateUUID();
-}
-
-/**
- * Icon name type for design system
- */
-export type IconName = "image" | "film" | "mic" | "sparkles" | "color-palette" | "brush";
-
-/**
- * Get icon name for creation type
- */
-export function getTypeIcon(type: CreationTypeId): IconName {
-  switch (type) {
-    case "text-to-video":
-    case "image-to-video":
-      return "film";
-    case "style-transfer":
-    case "colorization":
-      return "color-palette";
-    case "ai-brush":
-    case "inpainting":
-      return "brush";
-    default:
-      return "image";
-  }
-}
-
-/**
- * Get i18n key for creation type
- */
-export function getTypeTextKey(type: CreationTypeId): string {
-  return `creations.types.${type}`;
-}
-
-/**
- * Get formatted type text (fallback)
- */
-export function getTypeText(type: CreationTypeId): string {
-  return type.split("-").map(word =>
-    word.charAt(0).toUpperCase() + word.slice(1)
-  ).join(" ");
-}
-
-/**
- * Get creation title from prompt or type
- */
-export function getCreationTitle(
-  prompt?: string,
-  type?: CreationTypeId,
-  maxLength: number = 50
-): string {
-  if (prompt && prompt.length > 0) {
-    return prompt.length > maxLength
-      ? prompt.substring(0, maxLength) + "..."
-      : prompt;
-  }
-
-  if (type) {
-    return getTypeText(type);
-  }
-
-  return "Untitled Creation";
-}
-
-/**
- * Filter creations by search query (client-side)
- */
-export function filterBySearch<T extends { prompt?: string; type?: string; provider?: string }>(
-  items: T[],
-  searchQuery?: string,
-): T[] {
-  if (!searchQuery || searchQuery.trim().length === 0) {
-    return items;
-  }
-
-  const query = searchQuery.toLowerCase().trim();
-
-  return items.filter((item) =>
-    item.prompt?.toLowerCase().includes(query) ||
-    item.type?.toLowerCase().includes(query) ||
-    item.provider?.toLowerCase().includes(query)
-  );
-}
-
-/**
- * Sort creations by field
- */
-export function sortCreations<T extends Record<string, unknown>>(
-  items: T[],
-  field: keyof T,
-  order: "asc" | "desc" = "desc"
-): T[] {
-  return [...items].sort((a, b) => {
-    const aVal = a[field] as unknown;
-    const bVal = b[field] as unknown;
-
-    if (aVal === undefined && bVal === undefined) return 0;
-    if (aVal === undefined) return 1;
-    if (bVal === undefined) return -1;
-
-    if (typeof aVal === "string" && typeof bVal === "string") {
-      return order === "desc"
-        ? bVal.localeCompare(aVal)
-        : aVal.localeCompare(bVal);
-    }
-
-    if (typeof aVal === "number" && typeof bVal === "number") {
-      return order === "desc" ? bVal - aVal : aVal - bVal;
-    }
-
-    // Handle Date objects
-    if (aVal instanceof Date && bVal instanceof Date) {
-      return order === "desc"
-        ? bVal.getTime() - aVal.getTime()
-        : aVal.getTime() - bVal.getTime();
-    }
-
-    return 0;
-  });
-}
-
-/**
- * Truncate text with ellipsis
- */
-export function truncateText(text: string, maxLength: number): string {
-  if (text.length <= maxLength) return text;
-  return text.substring(0, maxLength - 3) + "...";
-}
+// Re-export all utilities for backward compatibility
+export * from "./creation-id.util";
+export * from "./creation-display.util";
+export * from "./creation-search.util";
+export * from "./creation-sort.util";
+export * from "./creation-format.util";

package/src/domains/creations/domain/utils/creation-id.util.ts

@@ -0,0 +1,13 @@
+/**
+ * Creation ID Utilities
+ * Single Responsibility: ID generation
+ */
+
+import { generateUUID } from "@umituz/react-native-design-system";
+
+/**
+ * Generate a unique creation ID using UUID v4
+ */
+export function generateCreationId(): string {
+  return generateUUID();
+}

package/src/domains/creations/domain/utils/creation-search.util.ts

@@ -0,0 +1,24 @@
+/**
+ * Creation Search Utilities
+ * Single Responsibility: Filtering and searching
+ */
+
+/**
+ * Filter creations by search query (client-side)
+ */
+export function filterBySearch<T extends { prompt?: string; type?: string; provider?: string }>(
+  items: T[],
+  searchQuery?: string,
+): T[] {
+  if (!searchQuery || searchQuery.trim().length === 0) {
+    return items;
+  }
+
+  const query = searchQuery.toLowerCase().trim();
+
+  return items.filter((item) =>
+    item.prompt?.toLowerCase().includes(query) ||
+    item.type?.toLowerCase().includes(query) ||
+    item.provider?.toLowerCase().includes(query)
+  );
+}

package/src/domains/creations/domain/utils/creation-sort.util.ts

@@ -0,0 +1,41 @@
+/**
+ * Creation Sort Utilities
+ * Single Responsibility: Sorting operations
+ */
+
+/**
+ * Sort creations by field
+ */
+export function sortCreations<T extends Record<string, unknown>>(
+  items: T[],
+  field: keyof T,
+  order: "asc" | "desc" = "desc"
+): T[] {
+  return [...items].sort((a, b) => {
+    const aVal = a[field] as unknown;
+    const bVal = b[field] as unknown;
+
+    if (aVal === undefined && bVal === undefined) return 0;
+    if (aVal === undefined) return 1;
+    if (bVal === undefined) return -1;
+
+    if (typeof aVal === "string" && typeof bVal === "string") {
+      return order === "desc"
+        ? bVal.localeCompare(aVal)
+        : aVal.localeCompare(bVal);
+    }
+
+    if (typeof aVal === "number" && typeof bVal === "number") {
+      return order === "desc" ? bVal - aVal : aVal - bVal;
+    }
+
+    // Handle Date objects
+    if (aVal instanceof Date && bVal instanceof Date) {
+      return order === "desc"
+        ? bVal.getTime() - aVal.getTime()
+        : aVal.getTime() - bVal.getTime();
+    }
+
+    return 0;
+  });
+}

package/src/domains/creations/infrastructure/repositories/CreationsFetcher.ts

@@ -1,10 +1,16 @@
-import { type FirestorePathResolver } from "@umituz/react-native-firebase";
+import type { CollectionReference, DocumentReference, DocumentData } from "firebase/firestore";
 import type { DocumentMapper } from "../../domain/value-objects/CreationsConfig";
 import type { Creation } from "../../domain/entities/Creation";
 import type { CreationsSubscriptionCallback, UnsubscribeFunction } from "../../domain/repositories/ICreationsRepository";
 import { CreationsQuery } from "./CreationsQuery";
 import { CreationsSubscription } from "./CreationsSubscription";
 
+/**
+ * Path resolver functions from BaseRepository
+ */
+export type GetUserCollection = (userId: string) => CollectionReference<DocumentData> | null;
+export type GetDocRef = (userId: string, documentId: string) => DocumentReference<DocumentData> | null;
+
 /**
  * CreationsFetcher
  * Orchestrates read operations for creations
@@ -19,11 +25,12 @@ export class CreationsFetcher {
     private readonly subscription: CreationsSubscription;
 
     constructor(
-        pathResolver: FirestorePathResolver,
+        getUserCollection: GetUserCollection,
+        getDocRef: GetDocRef,
         documentMapper: DocumentMapper,
     ) {
-        this.query = new CreationsQuery(pathResolver, documentMapper);
-        this.subscription = new CreationsSubscription(pathResolver, documentMapper);
+        this.query = new CreationsQuery(getUserCollection, getDocRef, documentMapper);
+        this.subscription = new CreationsSubscription(getUserCollection, getDocRef, documentMapper);
     }
 
     /**

package/src/domains/creations/infrastructure/repositories/CreationsQuery.ts

@@ -5,7 +5,7 @@
  */
 
 import { getDocs, getDoc, query, orderBy, where } from "firebase/firestore";
-import { type FirestorePathResolver } from "@umituz/react-native-firebase";
+import type { GetUserCollection, GetDocRef } from "./CreationsFetcher";
 import type { DocumentMapper } from "../../domain/value-objects/CreationsConfig";
 import type { Creation, CreationDocument } from "../../domain/entities/Creation";
 import { CREATION_FIELDS } from "../../domain/constants";
@@ -17,7 +17,8 @@ declare const __DEV__: boolean;
  */
 export class CreationsQuery {
     constructor(
-        private readonly pathResolver: FirestorePathResolver,
+        private readonly getUserCollection: GetUserCollection,
+        private readonly getDocRef: GetDocRef,
         private readonly documentMapper: DocumentMapper,
     ) { }
 
@@ -26,7 +27,7 @@ export class CreationsQuery {
      * Optimized query: Server-side filtering for non-deleted items
      */
     async getAll(userId: string): Promise<Creation[]> {
-        const userCollection = this.pathResolver.getUserCollection(userId);
+        const userCollection = this.getUserCollection(userId);
         if (!userCollection) return [];
 
         try {
@@ -62,7 +63,7 @@ export class CreationsQuery {
      * Get a single creation by ID
      */
     async getById(userId: string, id: string): Promise<Creation | null> {
-        const docRef = this.pathResolver.getDocRef(userId, id);
+        const docRef = this.getDocRef(userId, id);
         if (!docRef) return null;
 
         try {

package/src/domains/creations/infrastructure/repositories/CreationsRepository.ts

@@ -1,5 +1,5 @@
 
-import { BaseRepository, FirestorePathResolver } from "@umituz/react-native-firebase";
+import { BaseRepository } from "@umituz/react-native-firebase";
 import type {
   ICreationsRepository,
   CreationsSubscriptionCallback,
@@ -22,10 +22,9 @@ export interface RepositoryOptions {
 /**
  * Creations Repository Implementation
  * Delegates to specialized classes for different responsibilities
- * 
+ *
  * Architecture:
- * - Extends BaseRepository for centralized database access
- * - Uses FirestorePathResolver for path resolution
+ * - Extends BaseRepository for database access and path resolution
  * - Uses CreationsFetcher for read operations
  * - Uses CreationsWriter for write operations
  * - Standard path: users/{userId}/{collectionName}
@@ -33,7 +32,6 @@ export interface RepositoryOptions {
 export class CreationsRepository
   extends BaseRepository
   implements ICreationsRepository {
-  private readonly pathResolver: FirestorePathResolver;
   private readonly fetcher: CreationsFetcher;
   private readonly writer: CreationsWriter;
 
@@ -41,14 +39,20 @@ export class CreationsRepository
     collectionName: string,
     options?: RepositoryOptions,
   ) {
-    super();
+    super(collectionName);
 
     const documentMapper = options?.documentMapper ?? mapDocumentToCreation;
 
-    // Initialize with Firestore database instance from BaseRepository
-    this.pathResolver = new FirestorePathResolver(collectionName, this.getDb());
-    this.fetcher = new CreationsFetcher(this.pathResolver, documentMapper);
-    this.writer = new CreationsWriter(this.pathResolver);
+    // Pass BaseRepository methods directly to dependencies
+    this.fetcher = new CreationsFetcher(
+      (userId) => this.getUserCollection(userId),
+      (userId, docId) => this.getDocRef(userId, docId),
+      documentMapper
+    );
+    this.writer = new CreationsWriter(
+      (userId) => this.getUserCollection(userId),
+      (userId, docId) => this.getDocRef(userId, docId)
+    );
   }
 
   async getAll(userId: string): Promise<Creation[]> {

package/src/domains/creations/infrastructure/repositories/CreationsSubscription.ts

@@ -5,7 +5,7 @@
  */
 
 import { query, orderBy, onSnapshot, where } from "firebase/firestore";
-import { type FirestorePathResolver } from "@umituz/react-native-firebase";
+import type { GetUserCollection } from "./CreationsFetcher";
 import type { DocumentMapper } from "../../domain/value-objects/CreationsConfig";
 import type { Creation, CreationDocument } from "../../domain/entities/Creation";
 import type { CreationsSubscriptionCallback, UnsubscribeFunction } from "../../domain/repositories/ICreationsRepository";
@@ -15,76 +15,30 @@ declare const __DEV__: boolean;
 
 /**
  * Handles realtime subscriptions for creations
+ * Optimized with server-side filtering (80% data reduction)
  */
 export class CreationsSubscription {
     constructor(
-        private readonly pathResolver: FirestorePathResolver,
+        private readonly getUserCollection: GetUserCollection,
+        _getDocRef: unknown, // Not used in subscription, but accepted for consistent interface
         private readonly documentMapper: DocumentMapper,
     ) { }
 
-    /**
-     * Subscribes to realtime updates for user's creations
-     *
-     * PERFORMANCE OPTIMIZATION:
-     * - Server-side filtering with where clause (80% data reduction)
-     * - No client-side filtering needed
-     * - Requires Firestore composite index: (deletedAt ASC, createdAt DESC)
-     *
-     * @param userId - User ID to query
-     * @param onData - Callback for data updates
-     * @param onError - Optional error callback
-     * @returns Unsubscribe function
-     */
     subscribeToAll(
         userId: string,
         onData: CreationsSubscriptionCallback,
         onError?: (error: Error) => void,
     ): UnsubscribeFunction {
-        const userCollection = this.pathResolver.getUserCollection(userId);
+        const userCollection = this.getUserCollection(userId);
 
         if (!userCollection) {
-            return this.handleInvalidCollection(userId, onData, onError);
+            const error = new Error(`[CreationsSubscription] Invalid user collection: ${userId}`);
+            if (__DEV__) console.error(error.message);
+            onData([]);
+            onError?.(error);
+            return () => { if (__DEV__) console.log("[CreationsSubscription] No-op unsubscribe"); };
         }
 
-        return this.createRealtimeListener(userCollection, onData, onError);
-    }
-
-    /**
-     * Handles case when user collection is invalid
-     */
-    private handleInvalidCollection(
-        userId: string,
-        onData: CreationsSubscriptionCallback,
-        onError?: (error: Error) => void,
-    ): UnsubscribeFunction {
-        const error = new Error(`[CreationsSubscription] Cannot subscribe: Invalid user collection for userId: ${userId}`);
-
-        if (__DEV__) {
-            console.error(error.message);
-        }
-
-        // Return empty array immediately
-        onData([]);
-
-        // Report error to callback
-        onError?.(error);
-
-        // Return no-op unsubscribe function
-        return () => {
-            if (__DEV__) {
-                console.log("[CreationsSubscription] No-op unsubscribe called (no listener was created)");
-            }
-        };
-    }
-
-    /**
-     * Creates the realtime listener with optimized query
-     */
-    private createRealtimeListener(
-        userCollection: any,
-        onData: CreationsSubscriptionCallback,
-        onError?: (error: Error) => void,
-    ): UnsubscribeFunction {
         const q = query(
             userCollection,
             where(CREATION_FIELDS.DELETED_AT, "==", null),
@@ -101,22 +55,14 @@ export class CreationsSubscription {
                 });
 
                 if (__DEV__) {
-                    console.log("[CreationsSubscription] Realtime sync:", {
-                        count: creations.length,
-                        serverFiltered: true,
-                        hasChanges: snapshot.docChanges().length,
-                    });
+                    console.log("[CreationsSubscription] Sync:", creations.length, "items");
                 }
 
                 onData(creations);
             },
             (error: Error) => {
                 if (__DEV__) {
-                    console.error("[CreationsSubscription] Realtime subscription error:", {
-                        error: error.message,
-                        code: (error as { code?: string }).code,
-                        userId,
-                    });
+                    console.error("[CreationsSubscription] Error:", error.message);
                 }
                 onError?.(error);
             },

package/src/domains/creations/infrastructure/repositories/CreationsWriter.ts

@@ -3,7 +3,7 @@
  * Main class that orchestrates all creation write operations
  */
 
-import { type FirestorePathResolver } from "@umituz/react-native-firebase";
+import type { GetUserCollection, GetDocRef } from "./CreationsFetcher";
 import type { Creation } from "../../domain/entities/Creation";
 import * as operations from "./creations-operations";
 import * as stateOperations from "./creations-state-operations";
@@ -12,37 +12,40 @@ import * as stateOperations from "./creations-state-operations";
  * Handles write operations for creations
  */
 export class CreationsWriter {
-  constructor(private readonly pathResolver: FirestorePathResolver) {}
+  constructor(
+    private readonly getUserCollection: GetUserCollection,
+    private readonly getDocRef: GetDocRef,
+  ) {}
 
   async create(userId: string, creation: Creation): Promise<void> {
-    return operations.createCreation(this.pathResolver, userId, creation);
+    return operations.createCreation(this.getUserCollection, this.getDocRef, userId, creation);
   }
 
   async update(userId: string, id: string, updates: Partial<Creation>): Promise<boolean> {
-    return operations.updateCreation(this.pathResolver, userId, id, updates);
+    return operations.updateCreation(this.getDocRef, userId, id, updates);
   }
 
   async delete(userId: string, creationId: string): Promise<boolean> {
-    return operations.deleteCreation(this.pathResolver, userId, creationId);
+    return operations.deleteCreation(this.getDocRef, userId, creationId);
   }
 
   async hardDelete(userId: string, creationId: string): Promise<boolean> {
-    return operations.hardDeleteCreation(this.pathResolver, userId, creationId);
+    return operations.hardDeleteCreation(this.getDocRef, userId, creationId);
   }
 
   async restore(userId: string, creationId: string): Promise<boolean> {
-    return operations.restoreCreation(this.pathResolver, userId, creationId);
+    return operations.restoreCreation(this.getDocRef, userId, creationId);
   }
 
   async updateShared(userId: string, creationId: string, isShared: boolean): Promise<boolean> {
-    return stateOperations.updateCreationShared(this.pathResolver, userId, creationId, isShared);
+    return stateOperations.updateCreationShared(this.getDocRef, userId, creationId, isShared);
   }
 
   async updateFavorite(userId: string, creationId: string, isFavorite: boolean): Promise<boolean> {
-    return stateOperations.updateCreationFavorite(this.pathResolver, userId, creationId, isFavorite);
+    return stateOperations.updateCreationFavorite(this.getDocRef, userId, creationId, isFavorite);
   }
 
   async rate(userId: string, creationId: string, rating: number, description?: string): Promise<boolean> {
-    return stateOperations.rateCreation(this.pathResolver, userId, creationId, rating, description);
+    return stateOperations.rateCreation(this.getDocRef, userId, creationId, rating, description);
   }
 }

package/src/domains/creations/infrastructure/repositories/creation-create.operations.ts

@@ -3,18 +3,19 @@
  */
 
 import { setDoc } from "firebase/firestore";
-import { type FirestorePathResolver } from "@umituz/react-native-firebase";
+import type { GetUserCollection, GetDocRef } from "./CreationsFetcher";
 import type { Creation, CreationDocument } from "../../domain/entities/Creation";
 
 /**
  * Creates a new creation document
  */
 export async function createCreation(
-  pathResolver: FirestorePathResolver,
+  _getUserCollection: GetUserCollection,
+  getDocRef: GetDocRef,
   userId: string,
   creation: Creation
 ): Promise<void> {
-  const docRef = pathResolver.getDocRef(userId, creation.id);
+  const docRef = getDocRef(userId, creation.id);
   if (!docRef) throw new Error("Firestore not initialized");
 
   const data: CreationDocument = {

package/src/domains/creations/infrastructure/repositories/creation-delete.operations.ts

@@ -1,122 +1,86 @@
 /**
  * Creation Delete Operations
+ * Single Responsibility: Delete/restore operations with centralized error handling
  */
 
 import { updateDoc, deleteDoc } from "firebase/firestore";
-import { type FirestorePathResolver } from "@umituz/react-native-firebase";
-
-declare const __DEV__: boolean;
+import type { GetDocRef } from "./CreationsFetcher";
+import { logOperationError, logOperationSuccess, logInvalidRef } from "./creation-error-handler.util";
 
 /**
- * Soft deletes a creation
+ * Soft deletes a creation by setting deletedAt timestamp
  */
 export async function deleteCreation(
-  pathResolver: FirestorePathResolver,
+  getDocRef: GetDocRef,
   userId: string,
   creationId: string
 ): Promise<boolean> {
-  const docRef = pathResolver.getDocRef(userId, creationId);
+  const docRef = getDocRef(userId, creationId);
+  const context = { userId, creationId };
+
   if (!docRef) {
-    if (__DEV__) {
-      console.error("[CreationDelete] Cannot delete: Invalid document reference", {
-        userId,
-        creationId,
-      });
-    }
+    logInvalidRef("Delete", context);
     return false;
   }
 
   try {
     await updateDoc(docRef, { deletedAt: new Date() });
-    if (__DEV__) {
-      console.log("[CreationDelete] Soft deleted successfully", { userId, creationId });
-    }
+    logOperationSuccess("Delete", context);
     return true;
   } catch (error) {
-    if (__DEV__) {
-      console.error("[CreationDelete] Soft delete failed", {
-        userId,
-        creationId,
-        error: error instanceof Error ? error.message : String(error),
-        code: (error as { code?: string })?.code,
-      });
-    }
+    logOperationError("Delete", context, error);
     return false;
   }
 }
 
 /**
- * Hard deletes a creation
+ * Permanently deletes a creation from Firestore
  */
 export async function hardDeleteCreation(
-  pathResolver: FirestorePathResolver,
+  getDocRef: GetDocRef,
   userId: string,
   creationId: string
 ): Promise<boolean> {
-  const docRef = pathResolver.getDocRef(userId, creationId);
+  const docRef = getDocRef(userId, creationId);
+  const context = { userId, creationId };
+
   if (!docRef) {
-    if (__DEV__) {
-      console.error("[CreationDelete] Cannot hard delete: Invalid document reference", {
-        userId,
-        creationId,
-      });
-    }
+    logInvalidRef("HardDelete", context);
     return false;
   }
 
   try {
     await deleteDoc(docRef);
-    if (__DEV__) {
-      console.log("[CreationDelete] Hard deleted successfully", { userId, creationId });
-    }
+    logOperationSuccess("HardDelete", context);
     return true;
   } catch (error) {
-    if (__DEV__) {
-      console.error("[CreationDelete] Hard delete failed", {
-        userId,
-        creationId,
-        error: error instanceof Error ? error.message : String(error),
-        code: (error as { code?: string })?.code,
-      });
-    }
+    logOperationError("HardDelete", context, error);
     return false;
   }
 }
 
 /**
- * Restores a soft-deleted creation
+ * Restores a soft-deleted creation by clearing deletedAt
  */
 export async function restoreCreation(
-  pathResolver: FirestorePathResolver,
+  getDocRef: GetDocRef,
   userId: string,
   creationId: string
 ): Promise<boolean> {
-  const docRef = pathResolver.getDocRef(userId, creationId);
+  const docRef = getDocRef(userId, creationId);
+  const context = { userId, creationId };
+
   if (!docRef) {
-    if (__DEV__) {
-      console.error("[CreationDelete] Cannot restore: Invalid document reference", {
-        userId,
-        creationId,
-      });
-    }
+    logInvalidRef("Restore", context);
     return false;
   }
 
   try {
     await updateDoc(docRef, { deletedAt: null });
-    if (__DEV__) {
-      console.log("[CreationDelete] Restored successfully", { userId, creationId });
-    }
+    logOperationSuccess("Restore", context);
     return true;
   } catch (error) {
-    if (__DEV__) {
-      console.error("[CreationDelete] Restore failed", {
-        userId,
-        creationId,
-        error: error instanceof Error ? error.message : String(error),
-        code: (error as { code?: string })?.code,
-      });
-    }
+    logOperationError("Restore", context, error);
     return false;
   }
 }

package/src/domains/creations/infrastructure/repositories/creation-error-handler.util.ts

@@ -0,0 +1,36 @@
+/**
+ * Creation Error Handler Utility
+ * Single Responsibility: Centralized error logging
+ */
+
+declare const __DEV__: boolean;
+
+export function logOperationError(
+  operation: string,
+  context: { userId: string; creationId: string },
+  error: unknown
+): void {
+  if (!__DEV__) return;
+
+  console.error(`[Creation${operation}] Failed:`, {
+    ...context,
+    error: error instanceof Error ? error.message : String(error),
+    code: (error as { code?: string })?.code,
+  });
+}
+
+export function logOperationSuccess(
+  operation: string,
+  context: { userId: string; creationId: string }
+): void {
+  if (!__DEV__) return;
+  console.log(`[Creation${operation}] Success:`, context);
+}
+
+export function logInvalidRef(
+  operation: string,
+  context: { userId: string; creationId: string }
+): void {
+  if (!__DEV__) return;
+  console.error(`[Creation${operation}] Invalid document reference:`, context);
+}

package/src/domains/creations/infrastructure/repositories/creation-update.operations.ts

@@ -3,7 +3,7 @@
  */
 
 import { updateDoc } from "firebase/firestore";
-import { type FirestorePathResolver } from "@umituz/react-native-firebase";
+import type { GetDocRef } from "./CreationsFetcher";
 import type { Creation } from "../../domain/entities/Creation";
 import { CREATION_FIELDS, type CreationFieldName } from "../../domain/constants";
 
@@ -34,12 +34,12 @@ export const UPDATABLE_FIELDS: ReadonlyArray<CreationFieldName> = [
  * Updates a creation document
  */
 export async function updateCreation(
-  pathResolver: FirestorePathResolver,
+  getDocRef: GetDocRef,
   userId: string,
   id: string,
   updates: Partial<Creation>
 ): Promise<boolean> {
-  const docRef = pathResolver.getDocRef(userId, id);
+  const docRef = getDocRef(userId, id);
 
   if (!docRef) {
     throw new Error(

package/src/domains/creations/infrastructure/repositories/creations-state-operations.ts

@@ -4,19 +4,19 @@
  */
 
 import { updateDoc } from "firebase/firestore";
-import { type FirestorePathResolver } from "@umituz/react-native-firebase";
+import type { GetDocRef } from "./CreationsFetcher";
 import { submitFeedback } from "@umituz/react-native-subscription";
 
 /**
  * Updates the shared status of a creation
  */
 export async function updateCreationShared(
-  pathResolver: FirestorePathResolver,
+  getDocRef: GetDocRef,
   userId: string,
   creationId: string,
   isShared: boolean
 ): Promise<boolean> {
-  const docRef = pathResolver.getDocRef(userId, creationId);
+  const docRef = getDocRef(userId, creationId);
   if (!docRef) return false;
 
   try {
@@ -31,12 +31,12 @@ export async function updateCreationShared(
  * Updates the favorite status of a creation
  */
 export async function updateCreationFavorite(
-  pathResolver: FirestorePathResolver,
+  getDocRef: GetDocRef,
   userId: string,
   creationId: string,
   isFavorite: boolean
 ): Promise<boolean> {
-  const docRef = pathResolver.getDocRef(userId, creationId);
+  const docRef = getDocRef(userId, creationId);
   if (!docRef) return false;
 
   try {
@@ -51,13 +51,13 @@ export async function updateCreationFavorite(
  * Rates a creation and optionally submits feedback
  */
 export async function rateCreation(
-  pathResolver: FirestorePathResolver,
+  getDocRef: GetDocRef,
   userId: string,
   creationId: string,
   rating: number,
   description?: string
 ): Promise<boolean> {
-  const docRef = pathResolver.getDocRef(userId, creationId);
+  const docRef = getDocRef(userId, creationId);
   if (!docRef) return false;
 
   try {

package/src/domains/creations/presentation/hooks/useProcessingJobsPoller.ts

@@ -49,57 +49,56 @@ export function useProcessingJobsPoller(
     [creations],
   );
 
-  const pollJob = useCallback(
-    async (creation: Creation) => {
-      if (!userId || !creation.requestId || !creation.model) return;
-      if (pollingRef.current.has(creation.id)) return;
-
-      const provider = providerRegistry.getActiveProvider();
-      if (!provider || !provider.isInitialized()) return;
-
-      pollingRef.current.add(creation.id);
-
-      try {
-        if (typeof __DEV__ !== "undefined" && __DEV__) {
-          console.log("[ProcessingJobsPoller] Checking status:", creation.id);
-        }
-
-        const status = await provider.getJobStatus(creation.model, creation.requestId);
-
-        if (typeof __DEV__ !== "undefined" && __DEV__) {
-          console.log("[ProcessingJobsPoller] Status:", creation.id, status.status);
-        }
-
-        if (status.status === QUEUE_STATUS.COMPLETED) {
-          const result = await provider.getJobResult<FalResult>(creation.model, creation.requestId);
-          const urls = extractResultUrl(result);
-          if (typeof __DEV__ !== "undefined" && __DEV__) console.log("[ProcessingJobsPoller] Completed:", creation.id, urls);
-
-          const uri = urls.videoUrl || urls.imageUrl || "";
-          await repository.update(userId, creation.id, {
-            status: CREATION_STATUS.COMPLETED,
-            uri,
-            output: urls,
-          });
-        } else if (status.status === QUEUE_STATUS.FAILED) {
-          if (typeof __DEV__ !== "undefined" && __DEV__) console.log("[ProcessingJobsPoller] Failed:", creation.id);
-
-          await repository.update(userId, creation.id, {
-            status: CREATION_STATUS.FAILED,
-            metadata: { error: "Generation failed" },
-          });
-        }
-        // If still IN_PROGRESS or IN_QUEUE, we'll check again next interval
-      } catch (error) {
-        if (typeof __DEV__ !== "undefined" && __DEV__) {
-          console.error("[ProcessingJobsPoller] Poll error:", creation.id, error);
-        }
-      } finally {
-        pollingRef.current.delete(creation.id);
+  // Use ref for stable function reference to prevent effect re-runs
+  const pollJobRef = useRef<(creation: Creation) => Promise<void>>();
+
+  pollJobRef.current = async (creation: Creation) => {
+    if (!userId || !creation.requestId || !creation.model) return;
+    if (pollingRef.current.has(creation.id)) return;
+
+    const provider = providerRegistry.getActiveProvider();
+    if (!provider || !provider.isInitialized()) return;
+
+    pollingRef.current.add(creation.id);
+
+    try {
+      if (typeof __DEV__ !== "undefined" && __DEV__) {
+        console.log("[ProcessingJobsPoller] Checking status:", creation.id);
       }
-    },
-    [userId, repository],
-  );
+
+      const status = await provider.getJobStatus(creation.model, creation.requestId);
+
+      if (typeof __DEV__ !== "undefined" && __DEV__) {
+        console.log("[ProcessingJobsPoller] Status:", creation.id, status.status);
+      }
+
+      if (status.status === QUEUE_STATUS.COMPLETED) {
+        const result = await provider.getJobResult<FalResult>(creation.model, creation.requestId);
+        const urls = extractResultUrl(result);
+        if (typeof __DEV__ !== "undefined" && __DEV__) console.log("[ProcessingJobsPoller] Completed:", creation.id, urls);
+
+        const uri = urls.videoUrl || urls.imageUrl || "";
+        await repository.update(userId, creation.id, {
+          status: CREATION_STATUS.COMPLETED,
+          uri,
+          output: urls,
+        });
+      } else if (status.status === QUEUE_STATUS.FAILED) {
+        if (typeof __DEV__ !== "undefined" && __DEV__) console.log("[ProcessingJobsPoller] Failed:", creation.id);
+
+        await repository.update(userId, creation.id, {
+          status: CREATION_STATUS.FAILED,
+          metadata: { error: "Generation failed" },
+        });
+      }
+    } catch (error) {
+      if (typeof __DEV__ !== "undefined" && __DEV__) {
+        console.error("[ProcessingJobsPoller] Poll error:", creation.id, error);
+      }
+    } finally {
+      pollingRef.current.delete(creation.id);
+    }
+  };
 
   useEffect(() => {
     if (!enabled || !userId || processingJobs.length === 0) {
@@ -111,11 +110,11 @@ export function useProcessingJobsPoller(
     }
 
     // Initial poll
-    processingJobs.forEach((job) => void pollJob(job));
+    processingJobs.forEach((job) => pollJobRef.current?.(job));
 
     // Set up interval polling
     intervalRef.current = setInterval(() => {
-      processingJobs.forEach((job) => void pollJob(job));
+      processingJobs.forEach((job) => pollJobRef.current?.(job));
     }, DEFAULT_POLL_INTERVAL_MS);
 
     return () => {
@@ -128,7 +127,7 @@ export function useProcessingJobsPoller(
         intervalRef.current = null;
       }
     };
-  }, [enabled, userId, processingJobs, pollJob]);
+  }, [enabled, userId, processingJobs]);
 
   return {
     processingCount: processingJobs.length,