@umituz/react-native-ai-generation-content 1.65.1 → 1.65.2

package/package.json

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

package/src/domain/constants/processing-modes-catalog.constants.ts

@@ -0,0 +1,97 @@
+/**
+ * Processing Modes Catalog
+ * Domain Knowledge: Pre-configured image processing modes
+ */
+
+import type { ModeCatalog } from "../entities/processing-modes.types";
+
+export const DEFAULT_PROCESSING_MODES: ModeCatalog = {
+  clean_white: {
+    id: "clean_white",
+    icon: "square",
+    cost: 1,
+    premium: false,
+    requiresPrompt: false,
+    aiPrompt: `Replace the background with a clean, pure white background.
+Keep the subject perfectly intact with professional edges.
+Add subtle shadows beneath the subject for a grounded look.
+This should look like a professional product or portrait photo.`,
+  },
+  portrait_blur: {
+    id: "portrait_blur",
+    icon: "person",
+    cost: 1,
+    premium: false,
+    requiresPrompt: false,
+    aiPrompt: `Create a professional portrait with a beautifully blurred background (bokeh effect).
+Keep the subject in sharp focus with clean edges.
+The background should have a soft, creamy blur similar to f/1.4 depth of field.
+Maintain natural skin tones and lighting on the subject.`,
+  },
+  creative_scene: {
+    id: "creative_scene",
+    icon: "image",
+    cost: 2,
+    premium: false,
+    requiresPrompt: true,
+    aiPrompt: `Transform this image by placing the subject in a new creative scene.
+The subject must remain completely unchanged - same pose, expression, clothing.
+Seamlessly blend the subject into the new background with matched lighting.
+Create a professional, realistic composite that looks natural.`,
+  },
+  transparent: {
+    id: "transparent",
+    icon: "remove-circle",
+    cost: 1,
+    premium: false,
+    requiresPrompt: false,
+    aiPrompt: `Remove the background completely from this image.
+Keep the main subject perfectly intact with clean edges.
+Output should have a transparent or solid white background.
+Maintain all original details, colors, and lighting on the subject.`,
+  },
+  enhance: {
+    id: "enhance",
+    icon: "sparkles",
+    cost: 2,
+    premium: false,
+    requiresPrompt: false,
+    aiPrompt: `Enhance this image with professional quality improvements.
+Improve lighting, color balance, and overall image quality.
+Remove any imperfections while maintaining natural appearance.
+The result should look professionally retouched but realistic.`,
+  },
+  remove_object: {
+    id: "remove_object",
+    icon: "trash",
+    cost: 2,
+    premium: true,
+    requiresPrompt: true,
+    aiPrompt: `Remove unwanted objects from this image.
+Fill the removed areas with appropriate background content.
+The result should look natural with no visible artifacts.
+Maintain the overall composition and quality of the image.`,
+  },
+  replace_object: {
+    id: "replace_object",
+    icon: "swap-horizontal",
+    cost: 3,
+    premium: true,
+    requiresPrompt: true,
+    aiPrompt: `Replace the specified object in this image with a new one.
+The replacement should blend naturally with the scene.
+Match the lighting, perspective, and style of the original.
+Ensure the result looks realistic and professionally edited.`,
+  },
+  relight: {
+    id: "relight",
+    icon: "sunny",
+    cost: 2,
+    premium: true,
+    requiresPrompt: true,
+    aiPrompt: `Relight this image with professional studio lighting.
+Apply dramatic, flattering light that enhances the subject.
+Add subtle shadows and highlights for depth and dimension.
+The result should look like a professional studio photograph.`,
+  },
+};

package/src/domain/constants/processing-modes-filters.ts

@@ -0,0 +1,34 @@
+/**
+ * Processing Modes Filters
+ * Domain Service: Filter modes by criteria
+ */
+
+import type { ModeCatalog } from "../entities/processing-modes.types";
+import { DEFAULT_PROCESSING_MODES } from "./processing-modes-catalog.constants";
+
+/**
+ * Filter modes by premium status (free modes only)
+ */
+export function getFreeModes(modes: ModeCatalog = DEFAULT_PROCESSING_MODES): ModeCatalog {
+  return Object.fromEntries(
+    Object.entries(modes).filter(([, config]) => !config.premium)
+  );
+}
+
+/**
+ * Filter modes by premium status (premium modes only)
+ */
+export function getPremiumModes(modes: ModeCatalog = DEFAULT_PROCESSING_MODES): ModeCatalog {
+  return Object.fromEntries(
+    Object.entries(modes).filter(([, config]) => config.premium)
+  );
+}
+
+/**
+ * Get modes that require custom prompts
+ */
+export function getPromptRequiredModes(modes: ModeCatalog = DEFAULT_PROCESSING_MODES): ModeCatalog {
+  return Object.fromEntries(
+    Object.entries(modes).filter(([, config]) => config.requiresPrompt)
+  );
+}

package/src/domain/constants/processing-modes-getters.ts

@@ -0,0 +1,20 @@
+/**
+ * Processing Modes Getters
+ * Domain Service: Retrieve mode configurations
+ */
+
+import type { ImageProcessingMode, ModeCatalog, ModeConfig } from "../entities/processing-modes.types";
+import { DEFAULT_PROCESSING_MODES } from "./processing-modes-catalog.constants";
+
+/**
+ * Get mode configuration by ID
+ * Returns default transparent mode if not found
+ */
+export function getModeConfig(
+  mode: string,
+  customModes?: ModeCatalog
+): ModeConfig {
+  const modes = customModes || DEFAULT_PROCESSING_MODES;
+  const key = mode.replace("-", "_") as ImageProcessingMode;
+  return modes[key] || DEFAULT_PROCESSING_MODES.transparent;
+}

package/src/domain/constants/processing-modes.constants.ts

@@ -1,138 +1,12 @@
 /**
- * Default Image Processing Modes
+ * Processing Modes - Barrel Export
  * Pre-configured modes for common image processing tasks
- * Apps can use these defaults or provide their own configurations
+ *
+ * Architecture:
+ * - Domain Knowledge: Mode catalog (modes and their configurations)
+ * - Domain Services: Filters and getters for mode access
  */
 
-import type { ImageProcessingMode, ModeCatalog, ModeConfig } from "../entities/processing-modes.types";
-
-export const DEFAULT_PROCESSING_MODES: ModeCatalog = {
-    clean_white: {
-        id: "clean_white",
-        icon: "square",
-        cost: 1,
-        premium: false,
-        requiresPrompt: false,
-        aiPrompt: `Replace the background with a clean, pure white background.
-Keep the subject perfectly intact with professional edges.
-Add subtle shadows beneath the subject for a grounded look.
-This should look like a professional product or portrait photo.`,
-    },
-    portrait_blur: {
-        id: "portrait_blur",
-        icon: "person",
-        cost: 1,
-        premium: false,
-        requiresPrompt: false,
-        aiPrompt: `Create a professional portrait with a beautifully blurred background (bokeh effect).
-Keep the subject in sharp focus with clean edges.
-The background should have a soft, creamy blur similar to f/1.4 depth of field.
-Maintain natural skin tones and lighting on the subject.`,
-    },
-    creative_scene: {
-        id: "creative_scene",
-        icon: "image",
-        cost: 2,
-        premium: false,
-        requiresPrompt: true,
-        aiPrompt: `Transform this image by placing the subject in a new creative scene.
-The subject must remain completely unchanged - same pose, expression, clothing.
-Seamlessly blend the subject into the new background with matched lighting.
-Create a professional, realistic composite that looks natural.`,
-    },
-    transparent: {
-        id: "transparent",
-        icon: "remove-circle",
-        cost: 1,
-        premium: false,
-        requiresPrompt: false,
-        aiPrompt: `Remove the background completely from this image. 
-Keep the main subject perfectly intact with clean edges. 
-Output should have a transparent or solid white background.
-Maintain all original details, colors, and lighting on the subject.`,
-    },
-    enhance: {
-        id: "enhance",
-        icon: "sparkles",
-        cost: 2,
-        premium: false,
-        requiresPrompt: false,
-        aiPrompt: `Enhance this image with professional quality improvements.
-Improve lighting, color balance, and overall image quality.
-Remove any imperfections while maintaining natural appearance.
-The result should look professionally retouched but realistic.`,
-    },
-    remove_object: {
-        id: "remove_object",
-        icon: "trash",
-        cost: 2,
-        premium: true,
-        requiresPrompt: true,
-        aiPrompt: `Remove unwanted objects from this image.
-Fill the removed areas with appropriate background content.
-The result should look natural with no visible artifacts.
-Maintain the overall composition and quality of the image.`,
-    },
-    replace_object: {
-        id: "replace_object",
-        icon: "swap-horizontal",
-        cost: 3,
-        premium: true,
-        requiresPrompt: true,
-        aiPrompt: `Replace the specified object in this image with a new one.
-The replacement should blend naturally with the scene.
-Match the lighting, perspective, and style of the original.
-Ensure the result looks realistic and professionally edited.`,
-    },
-    relight: {
-        id: "relight",
-        icon: "sunny",
-        cost: 2,
-        premium: true,
-        requiresPrompt: true,
-        aiPrompt: `Relight this image with professional studio lighting.
-Apply dramatic, flattering light that enhances the subject.
-Add subtle shadows and highlights for depth and dimension.
-The result should look like a professional studio photograph.`,
-    },
-};
-
-/**
- * Get mode configuration by ID
- * Returns default transparent mode if not found
- */
-export const getModeConfig = (
-    mode: string,
-    customModes?: ModeCatalog
-): ModeConfig => {
-    const modes = customModes || DEFAULT_PROCESSING_MODES;
-    const key = mode.replace("-", "_") as ImageProcessingMode;
-    return modes[key] || DEFAULT_PROCESSING_MODES.transparent;
-};
-
-/**
- * Filter modes by premium status
- */
-export const getFreeModes = (modes: ModeCatalog = DEFAULT_PROCESSING_MODES): ModeCatalog => {
-    return Object.fromEntries(
-        Object.entries(modes).filter(([, config]) => !config.premium)
-    );
-};
-
-/**
- * Filter modes by premium status
- */
-export const getPremiumModes = (modes: ModeCatalog = DEFAULT_PROCESSING_MODES): ModeCatalog => {
-    return Object.fromEntries(
-        Object.entries(modes).filter(([, config]) => config.premium)
-    );
-};
-
-/**
- * Get modes that require custom prompts
- */
-export const getPromptRequiredModes = (modes: ModeCatalog = DEFAULT_PROCESSING_MODES): ModeCatalog => {
-    return Object.fromEntries(
-        Object.entries(modes).filter(([, config]) => config.requiresPrompt)
-    );
-};
+export { DEFAULT_PROCESSING_MODES } from "./processing-modes-catalog.constants";
+export { getFreeModes, getPremiumModes, getPromptRequiredModes } from "./processing-modes-filters";
+export { getModeConfig } from "./processing-modes-getters";

package/src/domain/entities/feature-flow-config.types.ts

@@ -0,0 +1,17 @@
+/**
+ * Feature Flow Configuration Types
+ */
+
+import type { DynamicStepDefinition } from "./step-definition.types";
+
+/**
+ * Feature Flow Configuration
+ * Defines complete flow for a feature/scenario
+ */
+export interface FeatureFlowConfig {
+  readonly id: string;
+  readonly name: string;
+  readonly steps: readonly DynamicStepDefinition[];
+  readonly initialStepId?: string;
+  readonly onComplete?: (data: Record<string, unknown>) => void | Promise<void>;
+}

package/src/domain/entities/flow-actions.types.ts

@@ -0,0 +1,26 @@
+/**
+ * Flow Actions Types
+ */
+
+import type { FlowUploadedImageData } from "./flow-config-data.types";
+
+/** Flow Actions */
+export interface FlowActions {
+  goToStep: (stepId: string) => void;
+  nextStep: () => void;
+  previousStep: () => void;
+  setCategory: (category: unknown) => void;
+  setScenario: (scenario: unknown) => void;
+  setPartnerImage: (partnerId: string, image: FlowUploadedImageData | undefined) => void;
+  setPartnerName: (partnerId: string, name: string) => void;
+  setTextInput: (text: string) => void;
+  setVisualStyle: (styleId: string) => void;
+  setSelectedFeatures: (featureType: string, ids: readonly string[]) => void;
+  setCustomData: (key: string, value: unknown) => void;
+  startGeneration: () => void;
+  updateProgress: (progress: number) => void;
+  setResult: (result: unknown) => void;
+  setError: (error: string) => void;
+  reset: () => void;
+  completeStep: (stepId: string) => void;
+}

package/src/domain/entities/flow-config-data.types.ts

@@ -0,0 +1,41 @@
+/**
+ * Flow Configuration Data Types
+ */
+
+/** Auth Gate Configuration */
+export interface AuthGateConfig {
+  readonly allowAnonymous?: boolean;
+  readonly onAuthRequired?: () => void;
+  readonly onAuthSuccess?: () => void;
+}
+
+/** Credit Gate Configuration */
+export interface CreditGateConfig {
+  readonly requiredCredits: number;
+  readonly onCreditsExhausted?: () => void;
+  readonly onCreditsAvailable?: () => void;
+}
+
+/** Partner Configuration */
+export interface PartnerConfig {
+  readonly partnerId: "A" | "B" | "single";
+  readonly showNameInput?: boolean;
+  readonly showFaceDetection?: boolean;
+  readonly showPhotoTips?: boolean;
+  readonly maxNameLength?: number;
+}
+
+/** Visual Style Option */
+export interface FlowVisualStyleData {
+  readonly id: string;
+  readonly icon: string;
+  readonly labelKey: string;
+  readonly promptModifier?: string;
+}
+
+/** Uploaded Image Data */
+export interface FlowUploadedImageData {
+  readonly uri: string;
+  readonly base64: string;
+  readonly mimeType: string;
+}

package/src/domain/entities/flow-config.types.ts

@@ -1,173 +1,21 @@
 /**
- * Flow Configuration Types
+ * Flow Configuration Types - Barrel Export
  * Generic multi-step flow system for AI generation
  */
 
-/** Step Types */
-export enum StepType {
-  // Gate steps - auth and credits check
-  AUTH_GATE = "auth_gate",
-  CREDIT_GATE = "credit_gate",
-  // Content steps
-  CATEGORY_SELECTION = "category_selection",
-  SCENARIO_SELECTION = "scenario_selection",
-  SCENARIO_PREVIEW = "scenario_preview",
-  PARTNER_UPLOAD = "partner_upload",
-  TEXT_INPUT = "text_input",
-  FEATURE_SELECTION = "feature_selection",
-  // Generation steps
-  GENERATING = "generating",
-  RESULT_PREVIEW = "result_preview",
-  CUSTOM = "custom",
-}
-
-/** Gate Step Result */
-export type GateResult = "passed" | "blocked" | "pending";
-
-/** Auth Gate Configuration */
-export interface AuthGateConfig {
-  readonly allowAnonymous?: boolean;
-  readonly onAuthRequired?: () => void;
-  readonly onAuthSuccess?: () => void;
-}
-
-/** Credit Gate Configuration */
-export interface CreditGateConfig {
-  readonly requiredCredits: number;
-  readonly onCreditsExhausted?: () => void;
-  readonly onCreditsAvailable?: () => void;
-}
-
-/** Partner Configuration */
-export interface PartnerConfig {
-  readonly partnerId: "A" | "B" | "single";
-  readonly showNameInput?: boolean;
-  readonly showFaceDetection?: boolean;
-  readonly showPhotoTips?: boolean;
-  readonly maxNameLength?: number;
-}
-
-/** Visual Style Option */
-export interface FlowVisualStyleData {
-  readonly id: string;
-  readonly icon: string;
-  readonly labelKey: string;
-  readonly promptModifier?: string;
-}
-
-/** Uploaded Image Data */
-export interface FlowUploadedImageData {
-  readonly uri: string;
-  readonly base64: string;
-  readonly mimeType: string;
-}
-
-/** Step Transition */
-export interface StepTransition {
-  readonly next?: string | ((state: FlowState) => string | null);
-  readonly back?: string;
-  readonly skipIf?: (state: FlowState) => boolean;
-}
-
-/** Step Definition */
-export interface StepDefinition<TConfig = unknown> {
-  readonly id: string;
-  readonly type: StepType;
-  readonly required?: boolean;
-  readonly config?: TConfig;
-  readonly transitions?: StepTransition;
-  readonly component?: React.ComponentType<StepComponentProps>;
-}
-
-/** Flow Generation Status - subset of GenerationStatus */
-export type FlowGenerationStatus = Extract<import("./generation.types").GenerationStatus, "idle" | "preparing" | "generating" | "completed" | "failed">;
-
-/** Flow State */
-export interface FlowState {
-  readonly currentStepId: string;
-  readonly currentStepIndex: number;
-  readonly completedSteps: readonly string[];
-  readonly selectedCategory?: unknown;
-  readonly selectedScenario?: unknown;
-  readonly partners: Record<string, FlowUploadedImageData | undefined>;
-  readonly partnerNames: Record<string, string>;
-  readonly textInput?: string;
-  readonly visualStyle?: string;
-  readonly selectedFeatures: Record<string, readonly string[]>;
-  readonly customData: Record<string, unknown>;
-  readonly generationStatus: FlowGenerationStatus;
-  readonly generationProgress: number;
-  readonly generationResult?: unknown;
-  readonly generationError?: string;
-}
-
-/** Flow Actions */
-export interface FlowActions {
-  goToStep: (stepId: string) => void;
-  nextStep: () => void;
-  previousStep: () => void;
-  setCategory: (category: unknown) => void;
-  setScenario: (scenario: unknown) => void;
-  setPartnerImage: (partnerId: string, image: FlowUploadedImageData | undefined) => void;
-  setPartnerName: (partnerId: string, name: string) => void;
-  setTextInput: (text: string) => void;
-  setVisualStyle: (styleId: string) => void;
-  setSelectedFeatures: (featureType: string, ids: readonly string[]) => void;
-  setCustomData: (key: string, value: unknown) => void;
-  startGeneration: () => void;
-  updateProgress: (progress: number) => void;
-  setResult: (result: unknown) => void;
-  setError: (error: string) => void;
-  reset: () => void;
-  completeStep: (stepId: string) => void;
-}
-
-/** Step Component Props */
-export interface StepComponentProps {
-  readonly step: StepDefinition;
-  readonly state: FlowState;
-  readonly actions: FlowActions;
-  readonly onNext: () => void;
-  readonly onBack: () => void;
-  readonly isProcessing: boolean;
-  readonly progress: number;
-  readonly error: string | null;
-}
-
-/** Flow Callbacks */
-export interface FlowCallbacks {
-  onAuthRequired?: (resume: () => void) => void;
-  onCreditsExhausted?: () => void;
-  onGenerationStart?: () => void;
-  onGenerationSuccess?: (result: unknown) => void;
-  onGenerationError?: (error: string) => void;
-  onStepChange?: (stepId: string, index: number) => void;
-  onFlowComplete?: (result: unknown) => void;
-}
-
-/** Flow Data Provider - App provides data */
-export interface FlowDataProvider {
-  readonly categories?: readonly unknown[];
-  readonly scenarios?: readonly unknown[];
-  readonly visualStyles?: readonly FlowVisualStyleData[];
-  readonly surprisePrompts?: readonly string[];
-}
-
-/** Flow Configuration */
-export interface FlowConfiguration {
-  readonly id: string;
-  readonly steps: readonly StepDefinition[];
-  readonly initialStepId?: string;
-  readonly callbacks?: FlowCallbacks;
-  readonly data?: FlowDataProvider;
-  readonly creditCost?: number;
-  readonly userId?: string;
-}
-
-/** Flow Features */
-export interface FlowFeatures {
-  readonly categorySelection: boolean;
-  readonly partnerCount: 0 | 1 | 2;
-  readonly textInput: boolean;
-  readonly scenarioSelection: boolean;
-}
+export { StepType, type GateResult, type StepTransition, type StepDefinition, type StepComponentProps } from "./flow-step.types";
+export type {
+  AuthGateConfig,
+  CreditGateConfig,
+  PartnerConfig,
+  FlowVisualStyleData,
+  FlowUploadedImageData,
+} from "./flow-config-data.types";
+export type { FlowState, FlowGenerationStatus } from "./flow-state.types";
+export type { FlowActions } from "./flow-actions.types";
+export type {
+  FlowCallbacks,
+  FlowDataProvider,
+  FlowConfiguration,
+  FlowFeatures,
+} from "./flow-configuration.types";

package/src/domain/entities/flow-configuration.types.ts

@@ -0,0 +1,44 @@
+/**
+ * Flow Configuration Types
+ */
+
+import type { StepDefinition } from "./flow-step.types";
+import type { FlowVisualStyleData } from "./flow-config-data.types";
+
+/** Flow Callbacks */
+export interface FlowCallbacks {
+  onAuthRequired?: (resume: () => void) => void;
+  onCreditsExhausted?: () => void;
+  onGenerationStart?: () => void;
+  onGenerationSuccess?: (result: unknown) => void;
+  onGenerationError?: (error: string) => void;
+  onStepChange?: (stepId: string, index: number) => void;
+  onFlowComplete?: (result: unknown) => void;
+}
+
+/** Flow Data Provider - App provides data */
+export interface FlowDataProvider {
+  readonly categories?: readonly unknown[];
+  readonly scenarios?: readonly unknown[];
+  readonly visualStyles?: readonly FlowVisualStyleData[];
+  readonly surprisePrompts?: readonly string[];
+}
+
+/** Flow Configuration */
+export interface FlowConfiguration {
+  readonly id: string;
+  readonly steps: readonly StepDefinition[];
+  readonly initialStepId?: string;
+  readonly callbacks?: FlowCallbacks;
+  readonly data?: FlowDataProvider;
+  readonly creditCost?: number;
+  readonly userId?: string;
+}
+
+/** Flow Features */
+export interface FlowFeatures {
+  readonly categorySelection: boolean;
+  readonly partnerCount: 0 | 1 | 2;
+  readonly textInput: boolean;
+  readonly scenarioSelection: boolean;
+}

package/src/domain/entities/flow-state.types.ts

@@ -0,0 +1,30 @@
+/**
+ * Flow State Types
+ */
+
+import type { FlowUploadedImageData } from "./flow-config-data.types";
+
+/** Flow Generation Status - subset of GenerationStatus */
+export type FlowGenerationStatus = Extract<
+  import("./generation.types").GenerationStatus,
+  "idle" | "preparing" | "generating" | "completed" | "failed"
+>;
+
+/** Flow State */
+export interface FlowState {
+  readonly currentStepId: string;
+  readonly currentStepIndex: number;
+  readonly completedSteps: readonly string[];
+  readonly selectedCategory?: unknown;
+  readonly selectedScenario?: unknown;
+  readonly partners: Record<string, FlowUploadedImageData | undefined>;
+  readonly partnerNames: Record<string, string>;
+  readonly textInput?: string;
+  readonly visualStyle?: string;
+  readonly selectedFeatures: Record<string, readonly string[]>;
+  readonly customData: Record<string, unknown>;
+  readonly generationStatus: FlowGenerationStatus;
+  readonly generationProgress: number;
+  readonly generationResult?: unknown;
+  readonly generationError?: string;
+}