@umituz/react-native-ai-generation-content 1.12.4 → 1.12.5

package/package.json

@@ -1,13 +1,16 @@
 {
   "name": "@umituz/react-native-ai-generation-content",
-  "version": "1.12.4",
+  "version": "1.12.5",
   "description": "Provider-agnostic AI generation orchestration for React Native",
   "main": "src/index.ts",
   "types": "src/index.ts",
   "exports": {
     ".": "./src/index.ts",
     "./prompts": "./src/domains/prompts/index.ts",
-    "./content-moderation": "./src/domains/content-moderation/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"
   },
   "files": [
     "src"
@@ -35,28 +38,48 @@
     "url": "git+https://github.com/umituz/react-native-ai-generation-content.git"
   },
   "peerDependencies": {
+    "@react-navigation/native": ">=6.0.0",
     "@tanstack/react-query": ">=5.0.0",
+    "@umituz/react-native-ai-gemini-provider": "latest",
+    "@umituz/react-native-alert": "latest",
     "@umituz/react-native-animation": "latest",
+    "@umituz/react-native-bottom-sheet": "latest",
     "@umituz/react-native-design-system": "latest",
+    "@umituz/react-native-firebase": "latest",
+    "@umituz/react-native-image": "latest",
+    "@umituz/react-native-localization": "latest",
     "@umituz/react-native-offline": "latest",
+    "@umituz/react-native-uuid": "latest",
     "expo-linear-gradient": ">=15.0.0",
+    "firebase": ">=10.0.0",
     "react": ">=18.0.0",
-    "react-native": ">=0.74.0"
+    "react-native": ">=0.74.0",
+    "react-native-safe-area-context": ">=4.0.0"
   },
   "devDependencies": {
     "@react-native-async-storage/async-storage": "2.2.0",
+    "@react-navigation/native": "^6.1.18",
     "@tanstack/react-query": "^5.0.0",
-    "@umituz/react-native-animation": "latest",
-    "@umituz/react-native-design-system": "latest",
-    "@umituz/react-native-offline": "latest",
     "@types/react": "~19.1.10",
     "@types/react-native": "^0.73.0",
     "@typescript-eslint/eslint-plugin": "^7.0.0",
     "@typescript-eslint/parser": "^7.0.0",
+    "@umituz/react-native-ai-gemini-provider": "latest",
+    "@umituz/react-native-alert": "latest",
+    "@umituz/react-native-animation": "latest",
+    "@umituz/react-native-bottom-sheet": "latest",
+    "@umituz/react-native-design-system": "latest",
+    "@umituz/react-native-firebase": "latest",
+    "@umituz/react-native-image": "latest",
+    "@umituz/react-native-localization": "latest",
+    "@umituz/react-native-offline": "latest",
+    "@umituz/react-native-uuid": "latest",
     "eslint": "^8.57.0",
     "expo-linear-gradient": "~15.0.7",
+    "firebase": "^11.1.0",
     "react": "19.1.0",
     "react-native": "0.81.5",
+    "react-native-safe-area-context": "^4.0.0",
     "typescript": "^5.3.0",
     "zustand": "^5.0.2"
   },

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

@@ -0,0 +1,71 @@
+import { serverTimestamp, addDoc, collection } from "firebase/firestore";
+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";
+
+export interface CreateCreationDTO {
+    userId: string;
+    type: CreationType;
+    prompt: string;
+    metadata?: Record<string, any>;
+    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) {
+            console.error(error);
+            throw error;
+        }
+    }
+
+    async getCreation(userId: string, id: string): Promise<any> {
+        return this.repository.getById(userId, id);
+    }
+
+    async updateCreation(
+        userId: string,
+        id: string,
+        updates: { metadata?: Record<string, any> },
+    ): 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,51 @@
+/**
+ * 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, any>;
+  readonly originalUri?: string;
+  readonly createdAt: Date;
+  readonly isShared: boolean;
+}
+
+export interface CreationDocument {
+  readonly uri?: string;
+  readonly prompt?: string;
+  readonly metadata?: Record<string, any>;
+  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 {
+  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: (data.createdAt as any)?.toDate?.() || (data.createdAt instanceof Date ? data.createdAt : new Date()),
+    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,76 @@
+/**
+ * Creations Configuration Value Object
+ * Defines the configuration for creations feature
+ */
+
+import type { Creation, CreationDocument } from "../entities/Creation";
+
+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;
+
+import type { FilterCategory } from "@umituz/react-native-bottom-sheet";
+
+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";