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

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

@@ -0,0 +1,56 @@
+/**
+ * Flow Step Types
+ */
+
+import type { FlowState } from "./flow-state.types";
+import type { FlowActions } from "./flow-actions.types";
+
+/** 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";
+
+/** 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>;
+}
+
+/** 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;
+}

package/src/domain/entities/scenario-step-config.types.ts

@@ -0,0 +1,32 @@
+/**
+ * Scenario Step Configuration Types
+ * Simplified config for scenario-based flows
+ */
+
+/**
+ * Scenario Step Configuration
+ */
+export interface ScenarioStepConfig {
+  readonly photoUploads?: {
+    readonly count: number;
+    readonly labels?: readonly string[];
+    readonly showFaceDetection?: boolean;
+    readonly showNameInput?: boolean;
+  };
+  readonly textInput?: {
+    readonly enabled: boolean;
+    readonly required?: boolean;
+    readonly minLength?: number;
+    readonly maxLength?: number;
+  };
+  readonly styleSelection?: {
+    readonly enabled: boolean;
+    readonly required?: boolean;
+    readonly styles?: readonly string[];
+  };
+  readonly durationSelection?: {
+    readonly enabled: boolean;
+    readonly required?: boolean;
+    readonly durations?: readonly number[];
+  };
+}

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

@@ -1,133 +1,18 @@
 /**
- * Dynamic Step Configuration Types
+ * Dynamic Step Configuration Types - Barrel Export
  * Configuration-driven wizard flow system
  */
 
-import type { StepType } from "./flow-config.types";
-
-/**
- * Photo Upload Step Config
- */
-export interface PhotoUploadStepConfig {
-  readonly id: string;
-  readonly label?: string; // "First Partner", "Your Photo", etc.
-  readonly titleKey?: string;
-  readonly subtitleKey?: string;
-  readonly showFaceDetection?: boolean;
-  readonly showNameInput?: boolean;
-  readonly showPhotoTips?: boolean;
-  readonly required?: boolean;
-}
-
-/**
- * Text Input Step Config
- */
-export interface TextInputStepConfig {
-  readonly id: string;
-  readonly titleKey?: string;
-  readonly placeholderKey?: string;
-  readonly minLength?: number;
-  readonly maxLength?: number;
-  readonly required?: boolean;
-}
-
-/**
- * Style Selection Step Config
- */
-export interface StyleSelectionStepConfig {
-  readonly id: string;
-  readonly titleKey?: string;
-  readonly styles: readonly string[]; // style IDs
-  readonly required?: boolean;
-}
-
-/**
- * Duration Selection Step Config
- */
-export interface DurationSelectionStepConfig {
-  readonly id: string;
-  readonly titleKey?: string;
-  readonly durations: readonly number[]; // seconds
-  readonly defaultDuration?: number;
-  readonly required?: boolean;
-}
-
-/**
- * Next Step Decision Function
- * Evaluates current state and determines next step
- */
-export type NextStepDecision = (context: {
-  readonly values: Record<string, unknown>;
-  readonly currentStepId: string;
-  readonly completedSteps: readonly string[];
-}) => string | null;
-
-/**
- * Step Definition with Configuration
- */
-export interface DynamicStepDefinition {
-  readonly id: string;
-  readonly type: StepType;
-  readonly enabled?: boolean;
-  readonly required?: boolean;
-  readonly config?:
-    | PhotoUploadStepConfig
-    | TextInputStepConfig
-    | StyleSelectionStepConfig
-    | DurationSelectionStepConfig
-    | Record<string, unknown>;
-  readonly nextStep?: string | NextStepDecision;
-  readonly skipIf?: (context: { readonly values: Record<string, unknown> }) => boolean;
-}
-
-/**
- * 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>;
-}
-
-/**
- * Scenario Step Configuration
- * Simplified config for scenario-based flows
- */
-export interface ScenarioStepConfig {
-  readonly photoUploads?: {
-    readonly count: number;
-    readonly labels?: readonly string[];
-    readonly showFaceDetection?: boolean;
-    readonly showNameInput?: boolean;
-  };
-  readonly textInput?: {
-    readonly enabled: boolean;
-    readonly required?: boolean;
-    readonly minLength?: number;
-    readonly maxLength?: number;
-  };
-  readonly styleSelection?: {
-    readonly enabled: boolean;
-    readonly required?: boolean;
-    readonly styles?: readonly string[];
-  };
-  readonly durationSelection?: {
-    readonly enabled: boolean;
-    readonly required?: boolean;
-    readonly durations?: readonly number[];
-  };
-}
-
-/**
- * Step Builder Result
- */
-export interface BuiltStep {
-  readonly id: string;
-  readonly type: StepType;
-  readonly config: Record<string, unknown>;
-  readonly required: boolean;
-  readonly nextStep?: string | NextStepDecision;
-}
+export type { PhotoUploadStepConfig } from "./step-upload-config.types";
+export type {
+  TextInputStepConfig,
+  StyleSelectionStepConfig,
+  DurationSelectionStepConfig,
+} from "./step-input-config.types";
+export type {
+  NextStepDecision,
+  DynamicStepDefinition,
+  BuiltStep,
+} from "./step-definition.types";
+export type { FeatureFlowConfig } from "./feature-flow-config.types";
+export type { ScenarioStepConfig } from "./scenario-step-config.types";

package/src/domain/entities/step-definition.types.ts

@@ -0,0 +1,50 @@
+/**
+ * Step Definition Types
+ */
+
+import type { StepType } from "./flow-config.types";
+import type { PhotoUploadStepConfig } from "./step-upload-config.types";
+import type {
+  TextInputStepConfig,
+  StyleSelectionStepConfig,
+  DurationSelectionStepConfig,
+} from "./step-input-config.types";
+
+/**
+ * Next Step Decision Function
+ * Evaluates current state and determines next step
+ */
+export type NextStepDecision = (context: {
+  readonly values: Record<string, unknown>;
+  readonly currentStepId: string;
+  readonly completedSteps: readonly string[];
+}) => string | null;
+
+/**
+ * Step Definition with Configuration
+ */
+export interface DynamicStepDefinition {
+  readonly id: string;
+  readonly type: StepType;
+  readonly enabled?: boolean;
+  readonly required?: boolean;
+  readonly config?:
+    | PhotoUploadStepConfig
+    | TextInputStepConfig
+    | StyleSelectionStepConfig
+    | DurationSelectionStepConfig
+    | Record<string, unknown>;
+  readonly nextStep?: string | NextStepDecision;
+  readonly skipIf?: (context: { readonly values: Record<string, unknown> }) => boolean;
+}
+
+/**
+ * Step Builder Result
+ */
+export interface BuiltStep {
+  readonly id: string;
+  readonly type: StepType;
+  readonly config: Record<string, unknown>;
+  readonly required: boolean;
+  readonly nextStep?: string | NextStepDecision;
+}

package/src/domain/entities/step-input-config.types.ts

@@ -0,0 +1,36 @@
+/**
+ * Input Step Configuration Types
+ */
+
+/**
+ * Text Input Step Config
+ */
+export interface TextInputStepConfig {
+  readonly id: string;
+  readonly titleKey?: string;
+  readonly placeholderKey?: string;
+  readonly minLength?: number;
+  readonly maxLength?: number;
+  readonly required?: boolean;
+}
+
+/**
+ * Style Selection Step Config
+ */
+export interface StyleSelectionStepConfig {
+  readonly id: string;
+  readonly titleKey?: string;
+  readonly styles: readonly string[];
+  readonly required?: boolean;
+}
+
+/**
+ * Duration Selection Step Config
+ */
+export interface DurationSelectionStepConfig {
+  readonly id: string;
+  readonly titleKey?: string;
+  readonly durations: readonly number[];
+  readonly defaultDuration?: number;
+  readonly required?: boolean;
+}

package/src/domain/entities/step-upload-config.types.ts

@@ -0,0 +1,17 @@
+/**
+ * Photo Upload Step Configuration Types
+ */
+
+/**
+ * Photo Upload Step Config
+ */
+export interface PhotoUploadStepConfig {
+  readonly id: string;
+  readonly label?: string;
+  readonly titleKey?: string;
+  readonly subtitleKey?: string;
+  readonly showFaceDetection?: boolean;
+  readonly showNameInput?: boolean;
+  readonly showPhotoTips?: boolean;
+  readonly required?: boolean;
+}

package/src/domain/interfaces/ai-provider-capabilities.types.ts

@@ -0,0 +1,27 @@
+/**
+ * AI Provider Capabilities Types
+ * Defines supported features and capabilities
+ */
+
+import type { ImageFeatureType, VideoFeatureType } from "./ai-provider-feature-types";
+
+/**
+ * Provider capabilities definition
+ * Describes what features and operations the provider supports
+ */
+export interface ProviderCapabilities {
+  /** Supported image features */
+  imageFeatures: readonly ImageFeatureType[];
+  /** Supported video features */
+  videoFeatures: readonly VideoFeatureType[];
+  /** Supports text-to-image generation */
+  textToImage: boolean;
+  /** Supports text-to-video generation */
+  textToVideo: boolean;
+  /** Supports image-to-video generation */
+  imageToVideo: boolean;
+  /** Supports text-to-voice generation */
+  textToVoice: boolean;
+  /** Supports text-to-text (LLM) generation */
+  textToText: boolean;
+}

package/src/domain/interfaces/ai-provider-config.types.ts

@@ -0,0 +1,30 @@
+/**
+ * AI Provider Configuration Types
+ * Configuration interface for AI provider initialization
+ */
+
+import type { ImageFeatureType, VideoFeatureType } from "./ai-provider-feature-types";
+
+/**
+ * AI Provider Configuration
+ * Contains API keys, retry settings, timeouts, and model mappings
+ */
+export interface AIProviderConfig {
+  apiKey: string;
+  maxRetries?: number;
+  baseDelay?: number;
+  maxDelay?: number;
+  defaultTimeoutMs?: number;
+  /** Text generation model ID */
+  textModel?: string;
+  /** Text-to-image generation model ID */
+  textToImageModel?: string;
+  /** Image editing model ID */
+  imageEditModel?: string;
+  /** Video generation model ID */
+  videoGenerationModel?: string;
+  /** Video feature model mapping - app provides models for each feature */
+  videoFeatureModels?: Partial<Record<VideoFeatureType, string>>;
+  /** Image feature model mapping - app provides models for each feature */
+  imageFeatureModels?: Partial<Record<ImageFeatureType, string>>;
+}

package/src/domain/interfaces/ai-provider-feature-types.ts

@@ -0,0 +1,22 @@
+/**
+ * AI Provider Feature Types
+ * Defines feature type enumerations for image and video processing
+ */
+
+/**
+ * Feature types for image processing (output: image)
+ */
+export type ImageFeatureType =
+  | "upscale"
+  | "photo-restore"
+  | "face-swap"
+  | "anime-selfie"
+  | "remove-background"
+  | "remove-object"
+  | "hd-touch-up"
+  | "replace-background";
+
+/**
+ * Feature types for video generation (output: video)
+ */
+export type VideoFeatureType = "image-to-video" | "text-to-video";

package/src/domain/interfaces/ai-provider-input.types.ts

@@ -0,0 +1,28 @@
+/**
+ * AI Provider Input Data Types
+ * Input data structures for feature execution
+ */
+
+/**
+ * Input data for image processing features
+ */
+export interface ImageFeatureInputData {
+  imageBase64: string;
+  targetImageBase64?: string;
+  prompt?: string;
+  options?: Record<string, unknown>;
+}
+
+/**
+ * Input data for video generation features
+ */
+export interface VideoFeatureInputData {
+  /** Source image (required for image-to-video, optional for text-to-video) */
+  sourceImageBase64?: string;
+  /** Target image (optional, used for dual-image features) */
+  targetImageBase64?: string;
+  /** Generation prompt (required for text-to-video) */
+  prompt?: string;
+  /** Additional generation options */
+  options?: Record<string, unknown>;
+}

package/src/domain/interfaces/ai-provider-progress.types.ts

@@ -0,0 +1,37 @@
+/**
+ * AI Provider Progress & Options Types
+ * Progress tracking and execution option types
+ */
+
+import type { AIJobStatusType, JobStatus } from "./ai-provider-status.types";
+
+/**
+ * Provider progress information
+ */
+export interface ProviderProgressInfo {
+  /** Progress percentage (0-100) */
+  progress: number;
+  /** Current job status */
+  status?: AIJobStatusType;
+  /** Human-readable message */
+  message?: string;
+  /** Estimated time remaining in ms */
+  estimatedTimeRemaining?: number;
+}
+
+/**
+ * Subscription options for job tracking
+ */
+export interface SubscribeOptions<T = unknown> {
+  timeoutMs?: number;
+  onQueueUpdate?: (status: JobStatus) => void;
+  onProgress?: (progress: ProviderProgressInfo) => void;
+  onResult?: (result: T) => void;
+}
+
+/**
+ * Basic run options
+ */
+export interface RunOptions {
+  onProgress?: (progress: ProviderProgressInfo) => void;
+}

package/src/domain/interfaces/ai-provider-status.types.ts

@@ -0,0 +1,41 @@
+/**
+ * AI Provider Status Types
+ * Job status tracking and logging types
+ */
+
+/**
+ * AI Job Status States
+ */
+export type AIJobStatusType =
+  | "IN_QUEUE"
+  | "IN_PROGRESS"
+  | "COMPLETED"
+  | "FAILED";
+
+/**
+ * Log entry for AI job events
+ */
+export interface AILogEntry {
+  message: string;
+  level: "info" | "warn" | "error";
+  timestamp?: string;
+}
+
+/**
+ * Job submission response
+ */
+export interface JobSubmission {
+  requestId: string;
+  statusUrl?: string;
+  responseUrl?: string;
+}
+
+/**
+ * Job status information
+ */
+export interface JobStatus {
+  status: AIJobStatusType;
+  logs?: AILogEntry[];
+  queuePosition?: number;
+  eta?: number;
+}