@umituz/react-native-ai-generation-content 1.12.25 → 1.12.26

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-ai-generation-content",
-  "version": "1.12.25",
+  "version": "1.12.26",
   "description": "Provider-agnostic AI generation orchestration for React Native",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -8,6 +8,7 @@
     ".": "./src/index.ts",
     "./prompts": "./src/domains/prompts/index.ts",
     "./content-moderation": "./src/domains/content-moderation/index.ts",
+    "./creations": "./src/domains/creations/index.ts",
     "./face-detection": "./src/domains/face-detection/index.ts",
     "./feature-background": "./src/domains/feature-background/index.ts"
   },
@@ -65,7 +66,7 @@
     "@typescript-eslint/eslint-plugin": "^7.0.0",
     "@typescript-eslint/parser": "^7.0.0",
     "@umituz/react-native-animation": "*",
-    "@umituz/react-native-design-system": "^2.3.31",
+    "@umituz/react-native-design-system": "^2.3.33",
     "@umituz/react-native-firebase": "*",
     "@umituz/react-native-haptics": "^1.0.2",
     "@umituz/react-native-image": "*",

package/src/domains/creations/application/services/CreationsService.ts

@@ -0,0 +1,73 @@
+
+import { generateUUID } from "@umituz/react-native-uuid";
+import type { ICreationsRepository } from "../../domain/repositories/ICreationsRepository";
+import type { ICreationsStorageService } from "../../domain/services/ICreationsStorageService";
+import type { CreationType } from "../../domain/value-objects";
+import { BaseRepository } from "@umituz/react-native-firebase";
+import type { Creation } from "../../domain/entities/Creation";
+
+export interface CreateCreationDTO {
+    userId: string;
+    type: CreationType;
+    prompt: string;
+    metadata?: Record<string, unknown>;
+    imageUri: string; // can be local file uri or base64
+    aspectRatio?: number;
+}
+
+export class CreationsService extends BaseRepository {
+    constructor(
+        private readonly repository: ICreationsRepository,
+        private readonly storageService: ICreationsStorageService,
+        private readonly _collectionName: string = "creations" // Default to generic name, app can override via repo
+    ) {
+        super();
+    }
+
+    async saveCreation(dto: CreateCreationDTO): Promise<string> {
+        const db = this.getDb();
+        if (!db) throw new Error("Firestore not initialized");
+
+        try {
+            const creationId = generateUUID();
+
+            const imageUrl = await this.storageService.uploadCreationImage(
+                dto.userId,
+                creationId,
+                dto.imageUri
+            );
+
+            await this.repository.create(dto.userId, {
+                id: creationId,
+                uri: imageUrl,
+                type: dto.type.id,
+                prompt: dto.prompt,
+                metadata: dto.metadata || {},
+                createdAt: new Date(),
+                isShared: false,
+            });
+
+            return creationId;
+        } catch (error) {
+            // eslint-disable-next-line no-console
+            console.error(error);
+            throw error;
+        }
+    }
+
+    async getCreation(userId: string, id: string): Promise<Creation | null> {
+        return this.repository.getById(userId, id);
+    }
+
+    async updateCreation(
+        userId: string,
+        id: string,
+        updates: { metadata?: Record<string, unknown> },
+    ): Promise<boolean> {
+        return this.repository.update(userId, id, updates);
+    }
+
+    async deleteCreation(userId: string, id: string): Promise<boolean> {
+        return this.repository.delete(userId, id);
+    }
+}

package/src/domains/creations/domain/entities/Creation.ts

@@ -0,0 +1,60 @@
+/**
+ * Creation Entity
+ * Represents an AI-generated creation
+ */
+
+export interface Creation {
+  readonly id: string;
+  readonly uri: string;
+  readonly type: string;
+  readonly prompt?: string;
+  readonly metadata?: Record<string, unknown>;
+  readonly originalUri?: string;
+  readonly createdAt: Date;
+  readonly isShared: boolean;
+}
+
+export interface CreationDocument {
+  readonly uri?: string;
+  readonly prompt?: string;
+  readonly metadata?: Record<string, unknown>;
+  readonly originalImage?: string;
+  readonly originalImageUrl?: string;
+  readonly transformedImage?: string;
+  readonly transformedImageUrl?: string;
+  readonly transformationType?: string;
+  readonly type?: string;
+  readonly status?: string;
+  readonly isShared: boolean;
+  readonly createdAt: FirebaseTimestamp | Date; // Allow Date for writing
+  readonly completedAt?: FirebaseTimestamp | Date;
+}
+
+interface FirebaseTimestamp {
+  toDate: () => Date;
+}
+
+export function mapDocumentToCreation(
+  id: string,
+  data: CreationDocument,
+): Creation {
+  let creationDate: Date;
+  if (data.createdAt instanceof Date) {
+    creationDate = data.createdAt;
+  } else if (data.createdAt && typeof data.createdAt === "object" && "toDate" in data.createdAt && typeof data.createdAt.toDate === "function") {
+    creationDate = data.createdAt.toDate();
+  } else {
+    creationDate = new Date();
+  }
+
+  return {
+    id,
+    uri: data.transformedImageUrl || data.transformedImage || data.uri || "",
+    type: data.transformationType || data.type || "unknown",
+    prompt: data.prompt,
+    metadata: data.metadata,
+    originalUri: data.originalImageUrl || data.originalImage,
+    createdAt: creationDate,
+    isShared: data.isShared ?? false,
+  };
+}

package/src/domains/creations/domain/entities/index.ts

@@ -0,0 +1,6 @@
+/**
+ * Domain Entities
+ */
+
+export type { Creation, CreationDocument } from "./Creation";
+export { mapDocumentToCreation } from "./Creation";

package/src/domains/creations/domain/repositories/ICreationsRepository.ts

@@ -0,0 +1,23 @@
+/**
+ * Creations Repository Interface
+ * Defines the contract for creations data access
+ */
+
+import type { Creation } from "../entities/Creation";
+
+export interface ICreationsRepository {
+  getAll(userId: string): Promise<Creation[]>;
+  getById(userId: string, id: string): Promise<Creation | null>;
+  create(userId: string, creation: Creation): Promise<void>;
+  update(
+    userId: string,
+    id: string,
+    updates: Partial<Creation>,
+  ): Promise<boolean>;
+  delete(userId: string, creationId: string): Promise<boolean>;
+  updateShared(
+    userId: string,
+    creationId: string,
+    isShared: boolean,
+  ): Promise<boolean>;
+}

package/src/domains/creations/domain/repositories/index.ts

@@ -0,0 +1,5 @@
+/**
+ * Domain Repository Interfaces
+ */
+
+export type { ICreationsRepository } from "./ICreationsRepository";

package/src/domains/creations/domain/services/ICreationsStorageService.ts

@@ -0,0 +1,13 @@
+export interface ICreationsStorageService {
+    uploadCreationImage(
+        userId: string,
+        creationId: string,
+        imageUri: string,
+        mimeType?: string
+    ): Promise<string>;
+
+    deleteCreationImage(
+        userId: string,
+        creationId: string
+    ): Promise<boolean>;
+}

package/src/domains/creations/domain/value-objects/CreationsConfig.ts

@@ -0,0 +1,75 @@
+/**
+ * Creations Configuration Value Object
+ * Defines the configuration for creations feature
+ */
+
+import type { Creation, CreationDocument } from "../entities/Creation";
+import type { FilterCategory } from "../../presentation/components/FilterBottomSheet";
+
+export interface CreationType {
+  readonly id: string;
+  readonly labelKey: string;
+  readonly icon: string;
+}
+
+export interface CreationsTranslations {
+  readonly title: string;
+  readonly subtitle: string;
+  readonly empty: string;
+  readonly emptyDescription: string;
+  readonly deleteTitle: string;
+  readonly deleteMessage: string;
+  readonly photoCount: string;
+  readonly filterAll: string;
+  readonly filterLabel: string;
+  readonly filterTitle: string;
+}
+
+/**
+ * Path builder function type
+ * Allows apps to define custom Firestore path structures
+ * @example
+ * // Default: users/{userId}/creations
+ * pathBuilder: (userId) => ["users", userId, "creations"]
+ * // Alternative: creations/{userId}/items
+ * pathBuilder: (userId) => ["creations", userId, "items"]
+ */
+export type PathBuilder = (userId: string) => string[];
+
+/**
+ * Document mapper function type
+ * Allows apps to map their specific document structure to Creation
+ */
+export type DocumentMapper = (id: string, data: CreationDocument) => Creation;
+
+export interface CreationsConfig {
+  readonly collectionName: string;
+  readonly types: readonly CreationType[];
+  readonly filterCategories?: readonly FilterCategory[];
+  readonly translations: CreationsTranslations;
+  readonly maxThumbnails?: number;
+  readonly gridColumns?: number;
+  readonly pathBuilder?: PathBuilder;
+  readonly documentMapper?: DocumentMapper;
+}
+
+export const DEFAULT_TRANSLATIONS: CreationsTranslations = {
+  title: "creations.title",
+  subtitle: "creations.subtitle",
+  empty: "creations.empty",
+  emptyDescription: "creations.emptyDescription",
+  deleteTitle: "creations.deleteTitle",
+  deleteMessage: "creations.deleteMessage",
+  photoCount: "creations.photoCount",
+  filterAll: "creations.filterAll",
+  filterLabel: "common.filter",
+  filterTitle: "common.filter",
+};
+
+export const DEFAULT_CONFIG: CreationsConfig = {
+  collectionName: "creations",
+  types: [],
+  translations: DEFAULT_TRANSLATIONS,
+  maxThumbnails: 4,
+  gridColumns: 2,
+};

package/src/domains/creations/domain/value-objects/index.ts

@@ -0,0 +1,12 @@
+/**
+ * Domain Value Objects
+ */
+
+export type {
+  CreationType,
+  CreationsTranslations,
+  CreationsConfig,
+  PathBuilder,
+  DocumentMapper,
+} from "./CreationsConfig";
+export { DEFAULT_TRANSLATIONS, DEFAULT_CONFIG } from "./CreationsConfig";

package/src/domains/creations/index.ts

@@ -0,0 +1,84 @@
+/**
+ * @umituz/react-native-ai-creations
+ *
+ * AI-generated creations gallery with filtering, sharing, and management
+ *
+ * Architecture:
+ * - Extends BaseRepository from @umituz/react-native-firestore
+ * - Fully dynamic path structure (configurable per app)
+ * - Fully dynamic document mapping (configurable per app)
+ * - App-agnostic: Works with any app, no app-specific code
+ *
+ * This package is designed to be used across hundreds of apps.
+ *
+ * Usage:
+ *   import {
+ *     CreationsGalleryScreen,
+ *     CreationsHomeCard,
+ *     useCreations,
+ *     createCreationsRepository,
+ *   } from '@umituz/react-native-ai-creations';
+ */
+
+// =============================================================================
+// DOMAIN LAYER - Entities
+// =============================================================================
+
+export type { Creation, CreationDocument } from "./domain/entities";
+export { mapDocumentToCreation } from "./domain/entities";
+
+// =============================================================================
+// DOMAIN LAYER - Value Objects
+// =============================================================================
+
+export type {
+  CreationType,
+  CreationsTranslations,
+  CreationsConfig,
+  PathBuilder,
+  DocumentMapper,
+} from "./domain/value-objects";
+export { DEFAULT_TRANSLATIONS, DEFAULT_CONFIG } from "./domain/value-objects";
+
+// =============================================================================
+// DOMAIN LAYER - Repository Interface
+// =============================================================================
+
+export type { ICreationsRepository } from "./domain/repositories";
+
+// =============================================================================
+// INFRASTRUCTURE LAYER
+// =============================================================================
+
+export {
+  CreationsRepository,
+  type RepositoryOptions,
+} from "./infrastructure/repositories";
+export { CreationsStorageService } from "./infrastructure/services/CreationsStorageService";
+export { createCreationsRepository } from "./infrastructure/adapters";
+export { CreationsService } from "./application/services/CreationsService";
+export type { ICreationsStorageService } from "./domain/services/ICreationsStorageService";
+
+// =============================================================================
+// PRESENTATION LAYER - Hooks
+// =============================================================================
+
+export { useCreations } from "./presentation/hooks/useCreations";
+export { useDeleteCreation } from "./presentation/hooks/useDeleteCreation";
+export { useCreationsFilter } from "./presentation/hooks/useCreationsFilter";
+
+// =============================================================================
+// PRESENTATION LAYER - Components
+// =============================================================================
+
+export { CreationThumbnail } from "./presentation/components/CreationThumbnail";
+export { CreationCard } from "./presentation/components/CreationCard";
+export { CreationsHomeCard } from "./presentation/components/CreationsHomeCard";
+export { FilterChips } from "./presentation/components/FilterChips";
+export { EmptyState } from "./presentation/components/EmptyState";
+
+// =============================================================================
+// PRESENTATION LAYER - Screens
+// =============================================================================
+
+export { CreationsGalleryScreen } from "./presentation/screens/CreationsGalleryScreen";

package/src/domains/creations/infrastructure/adapters/createRepository.ts

@@ -0,0 +1,54 @@
+/**
+ * Repository Factory
+ * Creates repository instance with given configuration
+ *
+ * Architecture:
+ * - Factory pattern for repository creation
+ * - Supports dynamic path structure per app
+ * - Supports custom document mapping per app
+ * - App-agnostic: No Firestore instance needed (BaseRepository handles it)
+ *
+ * This factory is designed to be used across hundreds of apps.
+ */
+
+import {
+  CreationsRepository,
+  type RepositoryOptions,
+} from "../repositories/CreationsRepository";
+import type { ICreationsRepository } from "../../domain/repositories/ICreationsRepository";
+
+/**
+ * Creates a new CreationsRepository instance
+ *
+ * @param collectionName - Firestore collection name
+ * @param options - Optional repository configuration
+ * @returns ICreationsRepository instance
+ *
+ * @example
+ * // Basic usage with default path (users/{userId}/photos)
+ * const repo = createCreationsRepository("photos");
+ *
+ * @example
+ * // Custom path structure
+ * const repo = createCreationsRepository("creations", {
+ *   pathBuilder: (userId) => ["gallery", userId, "items"],
+ * });
+ *
+ * @example
+ * // Custom document mapper
+ * const repo = createCreationsRepository("photos", {
+ *   documentMapper: (id, data) => ({
+ *     id,
+ *     uri: data.imageUrl,
+ *     type: data.category,
+ *     createdAt: data.timestamp?.toDate() || new Date(),
+ *     isShared: data.public ?? false,
+ *   }),
+ * });
+ */
+export function createCreationsRepository(
+  collectionName: string,
+  options?: RepositoryOptions,
+): ICreationsRepository {
+  return new CreationsRepository(collectionName, options);
+}

package/src/domains/creations/infrastructure/adapters/index.ts

@@ -0,0 +1,5 @@
+/**
+ * Infrastructure Adapters
+ */
+
+export { createCreationsRepository } from "./createRepository";

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

@@ -0,0 +1,241 @@
+/**
+ * Creations Repository Implementation
+ * Extends BaseRepository from @umituz/react-native-firestore
+ *
+ * Architecture:
+ * - Extends BaseRepository for centralized database access
+ * - Fully dynamic path structure (configurable per app)
+ * - Fully dynamic document mapping (configurable per app)
+ * - App-agnostic: Works with any app, no app-specific code
+ *
+ * This class is designed to be used across hundreds of apps.
+ */
+
+declare const __DEV__: boolean;
+
+import {
+  collection,
+  doc,
+  getDocs,
+  getDoc,
+  deleteDoc,
+  updateDoc,
+  query,
+  orderBy,
+  setDoc,
+} from "firebase/firestore";
+import { BaseRepository } from "@umituz/react-native-firebase";
+import type { ICreationsRepository } from "../../domain/repositories/ICreationsRepository";
+import type { Creation, CreationDocument } from "../../domain/entities/Creation";
+import { mapDocumentToCreation } from "../../domain/entities/Creation";
+import type {
+  PathBuilder,
+  DocumentMapper,
+} from "../../domain/value-objects/CreationsConfig";
+
+/**
+ * Repository options for dynamic configuration
+ * Apps can customize path structure and document mapping
+ */
+export interface RepositoryOptions {
+  /**
+   * Custom path builder function
+   * @example (userId) => ["users", userId, "photos"]
+   * @example (userId) => ["creations", userId, "items"]
+   */
+  readonly pathBuilder?: PathBuilder;
+
+  /**
+   * Custom document mapper function
+   * Maps Firestore documents to Creation entity
+   */
+  readonly documentMapper?: DocumentMapper;
+}
+
+/**
+ * Default path builder: users/{userId}/{collectionName}
+ */
+const createDefaultPathBuilder =
+  (collectionName: string): PathBuilder =>
+    (userId: string) =>
+      ["users", userId, collectionName];
+
+export class CreationsRepository
+  extends BaseRepository
+  implements ICreationsRepository {
+  private readonly pathBuilder: PathBuilder;
+  private readonly documentMapper: DocumentMapper;
+
+  constructor(
+    private readonly _collectionName: string,
+    options?: RepositoryOptions,
+  ) {
+    super();
+    this.pathBuilder =
+      options?.pathBuilder ?? createDefaultPathBuilder(_collectionName);
+    this.documentMapper = options?.documentMapper ?? mapDocumentToCreation;
+  }
+
+  private getUserCollection(userId: string) {
+    const db = this.getDb();
+    if (!db) return null;
+    const pathSegments = this.pathBuilder(userId);
+    return collection(db, pathSegments[0], ...pathSegments.slice(1));
+  }
+
+  private getDocRef(userId: string, creationId: string) {
+    const db = this.getDb();
+    if (!db) return null;
+    const pathSegments = this.pathBuilder(userId);
+    return doc(db, pathSegments[0], ...pathSegments.slice(1), creationId);
+  }
+
+  async getAll(userId: string): Promise<Creation[]> {
+    if (__DEV__) {
+      // eslint-disable-next-line no-console
+      console.log("[CreationsRepository] getAll()", { userId });
+    }
+
+    const userCollection = this.getUserCollection(userId);
+    if (!userCollection) return [];
+
+    try {
+      const q = query(userCollection, orderBy("createdAt", "desc"));
+      const snapshot = await getDocs(q);
+
+      if (__DEV__) {
+        // eslint-disable-next-line no-console
+        console.log("[CreationsRepository] Fetched:", snapshot.docs.length);
+      }
+
+      return snapshot.docs.map((docSnap) => {
+        const data = docSnap.data() as CreationDocument;
+        return this.documentMapper(docSnap.id, data);
+      });
+    } catch (error) {
+      if (__DEV__) {
+        // eslint-disable-next-line no-console
+        console.error("[CreationsRepository] getAll() ERROR", error);
+      }
+      return [];
+    }
+  }
+
+  async getById(userId: string, id: string): Promise<Creation | null> {
+    if (__DEV__) {
+      // eslint-disable-next-line no-console
+      console.log("[CreationsRepository] getById()", { userId, id });
+    }
+
+    const docRef = this.getDocRef(userId, id);
+    if (!docRef) return null;
+
+    try {
+      const docSnap = await getDoc(docRef);
+
+      if (!docSnap.exists()) {
+        if (__DEV__) {
+          // eslint-disable-next-line no-console
+          console.log("[CreationsRepository] Document not found");
+        }
+        return null;
+      }
+
+      const data = docSnap.data() as CreationDocument;
+      return this.documentMapper(docSnap.id, data);
+    } catch (error) {
+      if (__DEV__) {
+        // eslint-disable-next-line no-console
+        console.error("[CreationsRepository] getById() ERROR", error);
+      }
+      return null;
+    }
+  }
+
+  async create(userId: string, creation: Creation): Promise<void> {
+    const docRef = this.getDocRef(userId, creation.id);
+    if (!docRef) throw new Error("Firestore not initialized");
+
+    const data: CreationDocument = {
+      type: creation.type,
+      prompt: creation.prompt,
+      uri: creation.uri, // Use uri
+      createdAt: creation.createdAt,
+      metadata: creation.metadata || {},
+      isShared: creation.isShared || false,
+    };
+
+    await setDoc(docRef, data);
+  }
+
+  async update(
+    userId: string,
+    id: string,
+    updates: Partial<Creation>,
+  ): Promise<boolean> {
+    if (__DEV__) {
+      // eslint-disable-next-line no-console
+      console.log("[CreationsRepository] update()", { userId, id, updates });
+    }
+
+    const docRef = this.getDocRef(userId, id);
+    if (!docRef) return false;
+
+    try {
+      const updateData: Record<string, unknown> = {};
+
+      if (updates.metadata !== undefined) {
+        updateData.metadata = updates.metadata;
+      }
+      if (updates.isShared !== undefined) {
+        updateData.isShared = updates.isShared;
+      }
+      if (updates.uri !== undefined) {
+        updateData.uri = updates.uri;
+      }
+      if (updates.type !== undefined) {
+        updateData.type = updates.type;
+      }
+      if (updates.prompt !== undefined) {
+        updateData.prompt = updates.prompt;
+      }
+
+      await updateDoc(docRef, updateData);
+      return true;
+    } catch (error) {
+      if (__DEV__) {
+        // eslint-disable-next-line no-console
+        console.error("[CreationsRepository] update() ERROR", error);
+      }
+      return false;
+    }
+  }
+
+  async delete(userId: string, creationId: string): Promise<boolean> {
+    const docRef = this.getDocRef(userId, creationId);
+    if (!docRef) return false;
+
+    try {
+      await deleteDoc(docRef);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  async updateShared(
+    userId: string,
+    creationId: string,
+    isShared: boolean,
+  ): Promise<boolean> {
+    const docRef = this.getDocRef(userId, creationId);
+    if (!docRef) return false;
+
+    try {
+      await updateDoc(docRef, { isShared });
+      return true;
+    } catch {
+      return false;
+    }
+  }
+}