@umituz/react-native-ai-generation-content 1.17.166 → 1.17.168

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-ai-generation-content",
-  "version": "1.17.166",
+  "version": "1.17.168",
   "description": "Provider-agnostic AI generation orchestration for React Native",
   "main": "src/index.ts",
   "types": "src/index.ts",

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

@@ -10,6 +10,8 @@ import { useAuth } from "@umituz/react-native-auth";
 import { createCreationsRepository } from "../../infrastructure/adapters";
 import type { Creation } from "../../domain/entities/Creation";
 
+declare const __DEV__: boolean;
+
 /**
  * Configuration for creation persistence
  */
@@ -70,13 +72,24 @@ export function useCreationPersistence(
 
   const onProcessingStart = useCallback(
     <T extends BaseProcessingStartData>(data: T) => {
-      if (!userId) return;
+      if (__DEV__) {
+        console.log("[useCreationPersistence] onProcessingStart called", { type, userId, data });
+      }
+
+      if (!userId) {
+        if (__DEV__) console.log("[useCreationPersistence] No userId, skipping");
+        return;
+      }
 
       const { creationId, ...rest } = data;
       const cleanMetadata = Object.fromEntries(
         Object.entries(rest).filter(([, v]) => v !== undefined && v !== null),
       );
 
+      if (__DEV__) {
+        console.log("[useCreationPersistence] cleanMetadata", cleanMetadata);
+      }
+
       const creation: Creation = {
         id: creationId,
         uri: "",
@@ -88,6 +101,10 @@ export function useCreationPersistence(
         metadata: cleanMetadata,
       };
 
+      if (__DEV__) {
+        console.log("[useCreationPersistence] Creating document", { creationId, type });
+      }
+
       repository.create(userId, creation);
       queryClient.invalidateQueries({ queryKey: ["creations"] });
     },
@@ -96,7 +113,18 @@ export function useCreationPersistence(
 
   const onProcessingComplete = useCallback(
     <T extends BaseProcessingResult>(result: T) => {
-      if (!userId || !result.creationId) return;
+      if (__DEV__) {
+        console.log("[useCreationPersistence] onProcessingComplete called", {
+          creationId: result.creationId,
+          hasImageUrl: !!result.imageUrl,
+          hasVideoUrl: !!result.videoUrl,
+        });
+      }
+
+      if (!userId || !result.creationId) {
+        if (__DEV__) console.log("[useCreationPersistence] Missing userId or creationId, skipping");
+        return;
+      }
 
       const uri = result.imageUrl || result.videoUrl || "";
       const output = result.imageUrl
@@ -105,6 +133,13 @@ export function useCreationPersistence(
           ? { videoUrl: result.videoUrl }
           : undefined;
 
+      if (__DEV__) {
+        console.log("[useCreationPersistence] Updating document to completed", {
+          creationId: result.creationId,
+          uri: uri.substring(0, 50) + "...",
+        });
+      }
+
       repository.update(userId, result.creationId, {
         uri,
         status: "completed",
@@ -117,7 +152,18 @@ export function useCreationPersistence(
 
   const onError = useCallback(
     (error: string, creationId?: string) => {
-      if (!userId || !creationId) return;
+      if (__DEV__) {
+        console.log("[useCreationPersistence] onError called", { error, creationId });
+      }
+
+      if (!userId || !creationId) {
+        if (__DEV__) console.log("[useCreationPersistence] Missing userId or creationId, skipping");
+        return;
+      }
+
+      if (__DEV__) {
+        console.log("[useCreationPersistence] Updating document to failed", { creationId });
+      }
 
       repository.update(userId, creationId, {
         status: "failed",

package/src/domains/prompts/domain/entities/image-prompt-segments.ts

@@ -0,0 +1,119 @@
+/**
+ * Image Prompt Segments
+ * Reusable building blocks for composing AI image generation prompts
+ */
+
+// =============================================================================
+// IDENTITY PRESERVATION
+// =============================================================================
+
+export const IDENTITY_SEGMENTS = {
+  samePerson: "same person",
+  preserveIdentity: "preserve identity",
+  preserveGender: "preserve original gender",
+  preserveFace: "preserve original face structure",
+  preserveHair: "preserve original hair color and style",
+  preserveEyes: "preserve original eye color",
+  sameFeatures: "same facial features",
+  maintainLikeness: "maintain likeness",
+} as const;
+
+export const IDENTITY_NEGATIVE_SEGMENTS = {
+  genderSwap: "gender swap",
+  differentPerson: "different person",
+  wrongGender: "wrong gender",
+  changedIdentity: "changed identity",
+} as const;
+
+// =============================================================================
+// ANIME STYLE
+// =============================================================================
+
+export const ANIME_STYLE_SEGMENTS = {
+  base: "2D anime illustration",
+  japaneseStyle: "japanese anime art style",
+  celShaded: "cel-shaded anime character",
+  animeEyes: "large sparkling anime eyes with detailed iris",
+  animeSkin: "smooth cel-shaded skin with subtle anime blush",
+  animeHair: "stylized anime hair with highlights",
+  ghibli: "Studio Ghibli inspired",
+  vibrantColors: "vibrant anime colors",
+  cleanLineart: "clean anime lineart",
+  professionalPortrait: "professional anime portrait",
+} as const;
+
+// =============================================================================
+// QUALITY
+// =============================================================================
+
+export const QUALITY_SEGMENTS = {
+  highQuality: "high quality",
+  detailed: "highly detailed",
+  sharp: "sharp focus",
+  professional: "professional",
+  masterpiece: "masterpiece",
+  bestQuality: "best quality",
+} as const;
+
+export const QUALITY_NEGATIVE_SEGMENTS = {
+  lowQuality: "low quality",
+  blurry: "blurry",
+  pixelated: "pixelated",
+  artifacts: "jpeg artifacts",
+  watermark: "watermark",
+  signature: "signature",
+} as const;
+
+// =============================================================================
+// REALISM AVOIDANCE (for stylized outputs)
+// =============================================================================
+
+export const ANTI_REALISM_SEGMENTS = {
+  photorealistic: "photorealistic",
+  realisticPhoto: "realistic photo",
+  render3D: "3D render",
+  hyperrealistic: "hyperrealistic",
+  realPerson: "real person",
+  naturalSkin: "natural skin texture",
+  pores: "pores",
+  wrinkles: "wrinkles",
+} as const;
+
+// =============================================================================
+// ANATOMY NEGATIVE
+// =============================================================================
+
+export const ANATOMY_NEGATIVE_SEGMENTS = {
+  deformedFace: "deformed face",
+  badAnatomy: "bad anatomy",
+  extraLimbs: "extra limbs",
+  mutatedHands: "mutated hands",
+  extraFingers: "extra fingers",
+  missingFingers: "missing fingers",
+} as const;
+
+// =============================================================================
+// PRESET COLLECTIONS
+// =============================================================================
+
+export const PRESET_COLLECTIONS = {
+  fullIdentityPreservation: Object.values(IDENTITY_SEGMENTS),
+  basicIdentityPreservation: [
+    IDENTITY_SEGMENTS.samePerson,
+    IDENTITY_SEGMENTS.preserveGender,
+    IDENTITY_SEGMENTS.preserveFace,
+  ],
+  animeStyle: Object.values(ANIME_STYLE_SEGMENTS),
+  highQuality: Object.values(QUALITY_SEGMENTS),
+  antiRealism: Object.values(ANTI_REALISM_SEGMENTS),
+  anatomyNegative: Object.values(ANATOMY_NEGATIVE_SEGMENTS),
+  identityNegative: Object.values(IDENTITY_NEGATIVE_SEGMENTS),
+} as const;
+
+// =============================================================================
+// TYPES
+// =============================================================================
+
+export type IdentitySegment = keyof typeof IDENTITY_SEGMENTS;
+export type AnimeStyleSegment = keyof typeof ANIME_STYLE_SEGMENTS;
+export type QualitySegment = keyof typeof QUALITY_SEGMENTS;

package/src/domains/prompts/index.ts

@@ -320,4 +320,36 @@ export type {
   UsePromptGenerationActions,
 } from './presentation/hooks/usePromptGeneration';
 
-export { usePromptGeneration } from './presentation/hooks/usePromptGeneration';
+export { usePromptGeneration } from './presentation/hooks/usePromptGeneration';
+
+// =============================================================================
+// IMAGE PROMPT BUILDING
+// =============================================================================
+
+export {
+  IDENTITY_SEGMENTS,
+  IDENTITY_NEGATIVE_SEGMENTS,
+  ANIME_STYLE_SEGMENTS,
+  QUALITY_SEGMENTS,
+  QUALITY_NEGATIVE_SEGMENTS,
+  ANTI_REALISM_SEGMENTS,
+  ANATOMY_NEGATIVE_SEGMENTS,
+  PRESET_COLLECTIONS,
+} from './domain/entities/image-prompt-segments';
+
+export type {
+  IdentitySegment,
+  AnimeStyleSegment,
+  QualitySegment,
+} from './domain/entities/image-prompt-segments';
+
+export {
+  ImagePromptBuilder,
+  createAnimeSelfiePrompt,
+  createStyleTransferPrompt,
+} from './infrastructure/services/ImagePromptBuilder';
+
+export type {
+  ImagePromptResult,
+  ImagePromptBuilderOptions,
+} from './infrastructure/services/ImagePromptBuilder';

package/src/domains/prompts/infrastructure/services/ImagePromptBuilder.ts

@@ -0,0 +1,200 @@
+/**
+ * ImagePromptBuilder
+ * Fluent builder for composing AI image generation prompts
+ *
+ * @example
+ * const { prompt, negativePrompt } = ImagePromptBuilder.create()
+ *   .withIdentityPreservation()
+ *   .withAnimeStyle()
+ *   .withQuality()
+ *   .build();
+ */
+
+import {
+  IDENTITY_NEGATIVE_SEGMENTS,
+  ANIME_STYLE_SEGMENTS,
+  QUALITY_SEGMENTS,
+  QUALITY_NEGATIVE_SEGMENTS,
+  ANTI_REALISM_SEGMENTS,
+  ANATOMY_NEGATIVE_SEGMENTS,
+  PRESET_COLLECTIONS,
+} from "../../domain/entities/image-prompt-segments";
+
+export interface ImagePromptResult {
+  prompt: string;
+  negativePrompt: string;
+}
+
+export interface ImagePromptBuilderOptions {
+  separator?: string;
+}
+
+export class ImagePromptBuilder {
+  private positiveSegments: string[] = [];
+  private negativeSegments: string[] = [];
+  private readonly separator: string;
+
+  private constructor(options?: ImagePromptBuilderOptions) {
+    this.separator = options?.separator ?? ", ";
+  }
+
+  /**
+   * Create a new ImagePromptBuilder instance
+   */
+  static create(options?: ImagePromptBuilderOptions): ImagePromptBuilder {
+    return new ImagePromptBuilder(options);
+  }
+
+  /**
+   * Add identity preservation prompts
+   * Ensures the AI preserves the original person's features
+   */
+  withIdentityPreservation(full = true): this {
+    const segments = full
+      ? PRESET_COLLECTIONS.fullIdentityPreservation
+      : PRESET_COLLECTIONS.basicIdentityPreservation;
+
+    this.positiveSegments.push(...segments);
+    this.negativeSegments.push(...Object.values(IDENTITY_NEGATIVE_SEGMENTS));
+    return this;
+  }
+
+  /**
+   * Add anime style prompts
+   */
+  withAnimeStyle(): this {
+    this.positiveSegments.push(...Object.values(ANIME_STYLE_SEGMENTS));
+    this.negativeSegments.push(...Object.values(ANTI_REALISM_SEGMENTS));
+    return this;
+  }
+
+  /**
+   * Add quality enhancement prompts
+   */
+  withQuality(): this {
+    this.positiveSegments.push(...Object.values(QUALITY_SEGMENTS));
+    this.negativeSegments.push(...Object.values(QUALITY_NEGATIVE_SEGMENTS));
+    return this;
+  }
+
+  /**
+   * Add anatomy safety negative prompts
+   */
+  withAnatomySafety(): this {
+    this.negativeSegments.push(...Object.values(ANATOMY_NEGATIVE_SEGMENTS));
+    return this;
+  }
+
+  /**
+   * Add anti-realism prompts (for stylized outputs)
+   */
+  withAntiRealism(): this {
+    this.negativeSegments.push(...Object.values(ANTI_REALISM_SEGMENTS));
+    return this;
+  }
+
+  /**
+   * Add custom positive segments
+   */
+  withSegments(segments: string[]): this {
+    this.positiveSegments.push(...segments);
+    return this;
+  }
+
+  /**
+   * Add custom negative segments
+   */
+  withNegativeSegments(segments: string[]): this {
+    this.negativeSegments.push(...segments);
+    return this;
+  }
+
+  /**
+   * Add a single custom segment
+   */
+  withSegment(segment: string): this {
+    this.positiveSegments.push(segment);
+    return this;
+  }
+
+  /**
+   * Add a single negative segment
+   */
+  withNegativeSegment(segment: string): this {
+    this.negativeSegments.push(segment);
+    return this;
+  }
+
+  /**
+   * Prepend segments (add to beginning)
+   */
+  prependSegments(segments: string[]): this {
+    this.positiveSegments.unshift(...segments);
+    return this;
+  }
+
+  /**
+   * Create a new builder extending this one
+   */
+  extend(): ImagePromptBuilder {
+    const builder = ImagePromptBuilder.create({ separator: this.separator });
+    builder.positiveSegments = [...this.positiveSegments];
+    builder.negativeSegments = [...this.negativeSegments];
+    return builder;
+  }
+
+  /**
+   * Build the final prompt strings
+   */
+  build(): ImagePromptResult {
+    // Remove duplicates and filter empty values
+    const uniquePositive = [...new Set(this.positiveSegments)].filter(Boolean);
+    const uniqueNegative = [...new Set(this.negativeSegments)].filter(Boolean);
+
+    return {
+      prompt: uniquePositive.join(this.separator),
+      negativePrompt: uniqueNegative.join(this.separator),
+    };
+  }
+
+  /**
+   * Get current positive segments (for debugging)
+   */
+  getPositiveSegments(): string[] {
+    return [...this.positiveSegments];
+  }
+
+  /**
+   * Get current negative segments (for debugging)
+   */
+  getNegativeSegments(): string[] {
+    return [...this.negativeSegments];
+  }
+}
+
+// =============================================================================
+// PRESET BUILDERS
+// =============================================================================
+
+/**
+ * Create an anime selfie prompt builder with identity preservation
+ */
+export function createAnimeSelfiePrompt(): ImagePromptResult {
+  return ImagePromptBuilder.create()
+    .withIdentityPreservation()
+    .withAnimeStyle()
+    .withAnatomySafety()
+    .build();
+}
+
+/**
+ * Create a style transfer prompt builder with identity preservation
+ */
+export function createStyleTransferPrompt(style: string): ImagePromptResult {
+  return ImagePromptBuilder.create()
+    .withIdentityPreservation()
+    .withSegment(`${style} style`)
+    .withQuality()
+    .withAnatomySafety()
+    .build();
+}