@umituz/react-native-ai-fal-provider 3.2.38 → 3.2.40

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-ai-fal-provider",
-  "version": "3.2.38",
+  "version": "3.2.40",
   "description": "FAL AI provider for React Native - implements IAIProvider interface for unified AI generation",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
@@ -68,6 +68,7 @@
     "expo-clipboard": "^8.0.8",
     "expo-crypto": "^15.0.8",
     "expo-device": "^8.0.10",
+    "expo-document-picker": "~14.0.8",
     "expo-file-system": "^19.0.21",
     "expo-font": "^14.0.10",
     "expo-haptics": "^15.0.8",

package/src/global.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Global Type Declarations
+ * React Native globals and other global type definitions
+ */
+
+declare const __DEV__: boolean;
+
+declare global {
+  const __DEV__: boolean;
+}

package/src/index.ts

@@ -1,22 +1,156 @@
 /**
  * @umituz/react-native-ai-fal-provider
- * FAL AI provider for React Native - implements IAIProvider interface
+ * FAL AI provider for React Native - Public API exports
  */
 
-// Domain Layer
-export * from "./exports/domain";
+// ─── Core Provider ───────────────────────────────────────────────────────────
+export { FalProvider, falProvider } from "./infrastructure/services/fal-provider";
+export type { FalProvider as FalProviderType } from "./infrastructure/services/fal-provider";
+export { NSFWContentError } from "./infrastructure/services/nsfw-content-error";
 
-// Infrastructure Layer
-export * from "./exports/infrastructure";
-
-// Presentation Layer
-export * from "./exports/presentation";
+// ─── React Hook ───────────────────────────────────────────────────────────────
+export { useFalGeneration } from "./presentation/hooks/use-fal-generation";
+export type {
+  UseFalGenerationOptions,
+  UseFalGenerationResult,
+} from "./presentation/hooks/use-fal-generation";
+export {
+  FalGenerationStateManager,
+} from "./infrastructure/utils/fal-generation-state-manager.util";
+export type {
+  GenerationState,
+  GenerationStateOptions,
+} from "./infrastructure/utils/fal-generation-state-manager.util";
 
-// Init Module Factory
+// ─── Initialization ───────────────────────────────────────────────────────────
+export { initializeFalProvider } from "./init/initializeFalProvider";
 export {
   createAiProviderInitModule,
   type AiProviderInitModuleConfig,
-} from './init/createAiProviderInitModule';
+} from "./init/createAiProviderInitModule";
+
+// ─── Error Handling ───────────────────────────────────────────────────────────
+export {
+  mapFalError,
+  parseFalError,
+  isFalErrorRetryable,
+} from "./infrastructure/utils/fal-error-handler.util";
+export { FalErrorType } from "./domain/entities/error.types";
+export type {
+  FalErrorCategory,
+  FalErrorInfo,
+  FalErrorMessages,
+} from "./domain/entities/error.types";
 
-// Direct Initialization
-export { initializeFalProvider } from './init/initializeFalProvider';
+// ─── Utilities (public API) ────────────────────────────────────────────────────
+export {
+  getErrorMessage,
+  getErrorMessageOr,
+  formatErrorMessage,
+} from "./infrastructure/utils/helpers/error-helpers.util";
+
+export {
+  IMAGE_URL_FIELDS,
+  isImageField,
+} from "./infrastructure/utils/constants/image-fields.constants";
+export type { ImageUrlField } from "./infrastructure/utils/constants/image-fields.constants";
+
+export {
+  isDataUri,
+  isBase64DataUri,
+  extractMimeType,
+  extractBase64Content,
+} from "./infrastructure/utils/validators/data-uri-validator.util";
+
+export {
+  isEmptyString,
+  isNonEmptyString,
+  isString,
+} from "./infrastructure/utils/validators/string-validator.util";
+
+export {
+  isFalModelType,
+  isModelType,
+  isFalErrorType,
+  isValidBase64Image,
+  isValidApiKey,
+  isValidModelId,
+  isValidPrompt,
+  isValidTimeout,
+  isValidRetryCount,
+} from "./infrastructure/utils/type-guards";
+
+export {
+  formatImageDataUri,
+  extractBase64,
+  getDataUriExtension,
+} from "./infrastructure/utils/image-helpers.util";
+
+export {
+  uploadToFalStorage,
+  uploadMultipleToFalStorage,
+} from "./infrastructure/utils/fal-storage.util";
+
+export {
+  buildErrorMessage,
+  isDefined,
+  removeNullish,
+  generateUniqueId,
+  sleep,
+} from "./infrastructure/utils/helpers";
+
+export { preprocessInput } from "./infrastructure/utils/input-preprocessor.util";
+
+export {
+  calculateVideoCredits,
+  calculateImageCredits,
+  calculateCreditsFromConfig,
+} from "./infrastructure/utils/pricing/fal-pricing.util";
+export type { GenerationResolution } from "./infrastructure/utils/pricing/fal-pricing.util";
+
+// ─── Types (public API) ───────────────────────────────────────────────────────
+export type {
+  FalConfig,
+  FalModel,
+  FalModelType,
+  FalModelPricing,
+  FalJobInput,
+  FalJobResult,
+  FalLogEntry,
+  FalQueueStatus,
+  FalSubscribeOptions,
+} from "./domain/entities/fal.types";
+export type { FalModelConfig } from "./domain/types/fal-model-config.types";
+export type {
+  UpscaleOptions,
+  PhotoRestoreOptions,
+  FaceSwapOptions,
+  ImageToImagePromptConfig,
+  RemoveBackgroundOptions,
+  RemoveObjectOptions,
+  ReplaceBackgroundOptions,
+  VideoFromImageOptions,
+  TextToVideoOptions,
+  TextToVoiceOptions,
+  ImageFeatureType,
+  VideoFeatureType,
+  AIProviderConfig,
+  AIJobStatusType,
+  AILogEntry,
+  JobSubmission,
+  JobStatus,
+  ProviderProgressInfo,
+  SubscribeOptions,
+  RunOptions,
+  ProviderCapabilities,
+  ImageFeatureInputData,
+  VideoFeatureInputData,
+  IAIProvider,
+} from "./domain/types";
+
+// ─── Request Store Management ─────────────────────────────────────────────────
+export {
+  cleanupRequestStore,
+  stopAutomaticCleanup,
+} from "./infrastructure/services/request-store";
+export type { ActiveRequest } from "./infrastructure/services/request-store";

package/src/infrastructure/services/fal-provider-subscription.ts

@@ -90,14 +90,15 @@ function formatFalError(error: unknown): string {
     if (error.status === 402) {
       return "Insufficient credits. Please check your billing.";
     }
-    return error.message || `API error (${error.status})`;
+    return error.message ?? `API error (${error.status})`;
   }
 
   if (error instanceof Error) {
     return error.message;
   }
 
-  return String(error);
+  // Handle null/undefined/other types safely
+  return error != null ? String(error) : "Unknown error";
 }
 
 // ─── Retry Logic ────────────────────────────────────────────────────────────
@@ -113,8 +114,8 @@ function isRetryableSubscribeError(error: unknown): boolean {
   // Never retry NSFW
   if (error instanceof NSFWContentError) return false;
 
-  // Never retry user cancellation
-  if (error instanceof Error && error.message.includes("cancelled by user")) return false;
+  // Never retry user cancellation - check Error instance first
+  if (error instanceof Error && error.message?.includes("cancelled by user")) return false;
 
   // ApiError — check status code
   if (error instanceof ApiError) {
@@ -200,15 +201,16 @@ async function singleSubscribeAttempt<T = unknown>(
     ];
 
     if (signal) {
+      // Check for aborted state BEFORE adding listener to prevent race condition
+      if (signal.aborted) {
+        throw new Error("Request cancelled by user");
+      }
       const abortPromise = new Promise<never>((_, reject) => {
         abortHandler = () => reject(new Error("Request cancelled by user"));
         signal.addEventListener("abort", abortHandler, { once: true });
         listenerAdded = true;
       });
       promises.push(abortPromise);
-      if (signal.aborted) {
-        throw new Error("Request cancelled by user");
-      }
     }
 
     const rawResult = await Promise.race(promises);

package/src/infrastructure/services/fal-provider.ts

@@ -11,7 +11,7 @@ import type {
 } from "../../domain/types";
 import { DEFAULT_FAL_CONFIG, FAL_CAPABILITIES } from "./fal-provider.constants";
 import { handleFalSubscription, handleFalRun } from "./fal-provider-subscription";
-import { preprocessInput } from "../utils";
+import { preprocessInput } from "../utils/input-preprocessor.util";
 import { getErrorMessage } from "../utils/helpers/error-helpers.util";
 import { generationLogCollector } from "../utils/log-collector";
 import type { LogEntry } from "../utils/log-collector";

package/src/infrastructure/services/request-store.ts

@@ -56,7 +56,15 @@ function sortKeys(obj: unknown): unknown {
  * 64-bit combined hash space makes accidental collisions extremely unlikely.
  */
 export function createRequestKey(model: string, input: Record<string, unknown>): string {
-  const inputStr = JSON.stringify(sortKeys(input));
+  let inputStr: string;
+  try {
+    inputStr = JSON.stringify(sortKeys(input));
+  } catch (error) {
+    // Handle circular references or non-serializable values
+    // Fallback to a simple string representation that won't throw
+    const simpleKeys = Object.keys(input).sort().join(",");
+    inputStr = `${simpleKeys}:${Object.keys(input).length}`;
+  }
 
   // FNV-1a hash
   let h1 = 0x811c9dc5;
@@ -85,7 +93,7 @@ export function getExistingRequest<T>(key: string): ActiveRequest<T> | undefined
 export function storeRequest<T>(key: string, request: ActiveRequest<T>): void {
   getRequestStore().set(key, {
     ...request,
-    createdAt: request.createdAt ?? Date.now(),
+    createdAt: request.createdAt, // createdAt is required, no fallback needed
   });
   ensureCleanupRunning();
 }

package/src/infrastructure/utils/fal-error-handler.util.ts

@@ -61,7 +61,7 @@ function categorizeError(error: unknown): FalErrorCategory {
   }
 
   // 2. Standard Error - match message patterns
-  const message = (error instanceof Error ? error.message : String(error)).toLowerCase();
+  const message = (error instanceof Error ? error.message : error != null ? String(error) : "unknown").toLowerCase();
 
   for (const { type, patterns } of MESSAGE_PATTERNS) {
     if (patterns.some((p) => message.includes(p))) {
@@ -81,8 +81,11 @@ function extractMessage(error: unknown): string {
   // ValidationError - extract field-level messages
   if (error instanceof ValidationError) {
     const fieldErrors = error.fieldErrors;
-    if (fieldErrors.length > 0) {
-      const messages = fieldErrors.map((e) => e.msg).filter(Boolean);
+    if (Array.isArray(fieldErrors) && fieldErrors.length > 0) {
+      // Safely extract messages from field errors with validation
+      const messages = fieldErrors
+        .map((e) => (e && typeof e === 'object' && 'msg' in e && typeof e.msg === 'string' ? e.msg : null))
+        .filter((msg): msg is string => msg !== null);
       if (messages.length > 0) return messages.join("; ");
     }
     return error.message;
@@ -90,10 +93,35 @@ function extractMessage(error: unknown): string {
 
   // ApiError - extract from body or message
   if (error instanceof ApiError) {
-    // body may contain detail array
-    const body = error.body as { detail?: Array<{ msg?: string }> } | undefined;
-    if (body?.detail?.[0]?.msg) {
-      return body.detail[0].msg;
+    // body may contain detail array - validate structure before access
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-assignment
+    const body = error.body;
+
+    // Type guard for detail array structure
+    interface DetailItem {
+      msg?: string;
+    }
+    interface BodyWithDetail {
+      detail?: DetailItem[];
+    }
+
+    const validatedBody = body as BodyWithDetail | undefined;
+
+    if (
+      validatedBody &&
+      validatedBody.detail &&
+      Array.isArray(validatedBody.detail) &&
+      validatedBody.detail.length > 0
+    ) {
+      const firstItem = validatedBody.detail[0];
+      if (
+        firstItem &&
+        typeof firstItem === "object" &&
+        typeof firstItem.msg === "string" &&
+        firstItem.msg
+      ) {
+        return firstItem.msg;
+      }
     }
     return error.message;
   }
@@ -103,7 +131,7 @@ function extractMessage(error: unknown): string {
     return error.message;
   }
 
-  return String(error);
+  return error != null ? String(error) : "Unknown error";
 }
 
 /**

package/src/infrastructure/utils/fal-storage.util.ts

@@ -10,6 +10,7 @@ import {
   deleteTempFile,
 } from "@umituz/react-native-design-system/filesystem";
 import { getErrorMessage } from './helpers/error-helpers.util';
+import { getElapsedTime, getActualSizeKB } from './helpers';
 import { generationLogCollector } from './log-collector';
 import { UPLOAD_CONFIG } from '../services/fal-provider.constants';
 
@@ -72,13 +73,14 @@ async function withRetry<T>(
  */
 export async function uploadToFalStorage(base64: string, sessionId: string): Promise<string> {
   const startTime = Date.now();
-  const sizeKB = Math.round(base64.length / 1024);
-  const actualSizeKB = Math.round(sizeKB * 0.75); // base64 inflates ~33%
+  const actualSizeKB = getActualSizeKB(base64);
   generationLogCollector.log(sessionId, TAG, `Starting upload (~${actualSizeKB}KB actual)`);
 
   const tempUri = await base64ToTempFile(base64);
 
-  if (!tempUri) {
+  // base64ToTempFile returns a string, so this check is for defensive programming
+  // in case the implementation changes in the future
+  if (!tempUri || typeof tempUri !== 'string') {
     throw new Error("Failed to create temporary file from base64 data");
   }
 
@@ -86,6 +88,12 @@ export async function uploadToFalStorage(base64: string, sessionId: string): Pro
     const url = await withRetry(
       async () => {
         const response = await fetch(tempUri);
+
+        // Validate response before processing blob
+        if (!response.ok) {
+          throw new Error(`Failed to fetch temp file: HTTP ${response.status} ${response.statusText}`);
+        }
+
         const blob = await response.blob();
         generationLogCollector.log(sessionId, TAG, `Blob created (${blob.size} bytes), uploading to FAL CDN...`);
         return withTimeout(
@@ -98,11 +106,11 @@ export async function uploadToFalStorage(base64: string, sessionId: string): Pro
       'upload',
     );
 
-    const elapsed = Date.now() - startTime;
+    const elapsed = getElapsedTime(startTime);
     generationLogCollector.log(sessionId, TAG, `Upload complete in ${elapsed}ms`, { url, actualSizeKB, elapsed });
     return url;
   } catch (error) {
-    const elapsed = Date.now() - startTime;
+    const elapsed = getElapsedTime(startTime);
     generationLogCollector.error(sessionId, TAG, `Upload FAILED after ${elapsed}ms: ${getErrorMessage(error)}`, { actualSizeKB, elapsed });
     throw error;
   } finally {
@@ -125,6 +133,12 @@ export async function uploadLocalFileToFalStorage(fileUri: string, sessionId: st
     const url = await withRetry(
       async () => {
         const response = await fetch(fileUri);
+
+        // Validate response before processing blob
+        if (!response.ok) {
+          throw new Error(`Failed to fetch local file: HTTP ${response.status} ${response.statusText}`);
+        }
+
         const blob = await response.blob();
         generationLogCollector.log(sessionId, TAG, `Local file blob (${blob.size} bytes), uploading...`);
         return withTimeout(

package/src/infrastructure/utils/helpers/calculation-helpers.util.ts

@@ -0,0 +1,168 @@
+/**
+ * Calculation Helper Utilities
+ * Centralized calculation functions for consistent metrics across the codebase
+ */
+
+/**
+ * Calculate elapsed time in milliseconds from a start timestamp
+ *
+ * @param startTime - Start timestamp in milliseconds (from Date.now())
+ * @returns Elapsed time in milliseconds
+ *
+ * @example
+ * ```typescript
+ * const start = Date.now();
+ * // ... do work ...
+ * const elapsed = getElapsedTime(start); // e.g., 1234
+ * ```
+ */
+export function getElapsedTime(startTime: number): number {
+  return Date.now() - startTime;
+}
+
+/**
+ * Format elapsed time in milliseconds to human-readable string
+ *
+ * @param elapsedMs - Elapsed time in milliseconds
+ * @returns Formatted string (e.g., "1234ms", "1.2s")
+ *
+ * @example
+ * ```typescript
+ * formatDuration(1234); // "1234ms"
+ * formatDuration(1200); // "1.2s"
+ * formatDuration(1500); // "1.5s"
+ * ```
+ */
+export function formatDuration(elapsedMs: number): string {
+  if (elapsedMs < 1000) {
+    return `${Math.round(elapsedMs)}ms`;
+  }
+  return `${(elapsedMs / 1000).toFixed(1)}s`;
+}
+
+/**
+ * Convert bytes to kilobytes (KB)
+ *
+ * @param bytes - Size in bytes
+ * @returns Size in kilobytes (rounded)
+ *
+ * @example
+ * ```typescript
+ * bytesToKB(5000); // 5
+ * bytesToKB(1536); // 2
+ * ```
+ */
+export function bytesToKB(bytes: number): number {
+  return Math.round(bytes / 1024);
+}
+
+/**
+ * Calculate actual file size from base64 string
+ * Base64 encoding inflates size by ~33%, so actual size is ~75% of base64 length
+ *
+ * @param base64String - Base64 encoded string
+ * @returns Actual size in kilobytes (rounded)
+ *
+ * @example
+ * ```typescript
+ * getActualSizeKB("data:image/png;base64,iVBOR..."); // ~3KB for 4KB base64
+ * ```
+ */
+export function getActualSizeKB(base64String: string): number {
+  const base64SizeKB = Math.round(base64String.length / 1024);
+  // Base64 inflates by ~33%, so actual size is ~75%
+  return Math.round(base64SizeKB * 0.75);
+}
+
+/**
+ * Calculate base64 size in KB (before inflation adjustment)
+ *
+ * @param base64String - Base64 encoded string
+ * @returns Size in kilobytes (rounded)
+ *
+ * @example
+ * ```typescript
+ * getBase64SizeKB("data:image/png;base64,iVBOR..."); // 4
+ * ```
+ */
+export function getBase64SizeKB(base64String: string): number {
+  return Math.round(base64String.length / 1024);
+}
+
+/**
+ * Calculate success rate as percentage
+ *
+ * @param successCount - Number of successful operations
+ * @param totalCount - Total number of operations
+ * @returns Success rate as percentage (0-100)
+ *
+ * @example
+ * ```typescript
+ * getSuccessRate(8, 10); // 80
+ * getSuccessRate(5, 5); // 100
+ * getSuccessRate(0, 10); // 0
+ * ```
+ */
+export function getSuccessRate(successCount: number, totalCount: number): number {
+  if (totalCount === 0) return 0;
+  return Math.round((successCount / totalCount) * 100);
+}
+
+/**
+ * Format bytes to human-readable size
+ *
+ * @param bytes - Size in bytes
+ * @returns Formatted string (e.g., "1.5KB", "2.3MB")
+ *
+ * @example
+ * ```typescript
+ * formatBytes(1536); // "1.5KB"
+ * formatBytes(2048000); // "2.0MB"
+ * formatBytes(500); // "500B"
+ * ```
+ */
+export function formatBytes(bytes: number): string {
+  if (bytes < 1024) return `${bytes}B`;
+  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)}KB`;
+  return `${(bytes / (1024 * 1024)).toFixed(1)}MB`;
+}
+
+/**
+ * Calculate retry count suffix for logging
+ *
+ * @param attempt - Current attempt number (0-indexed)
+ * @param totalAttempts - Total number of attempts
+ * @returns Formatted suffix string
+ *
+ * @example
+ * ```typescript
+ * getRetrySuffix(1, 2); // " (succeeded on retry 1)"
+ * getRetrySuffix(0, 1); // ""
+ * ```
+ */
+export function getRetrySuffix(attempt: number, _totalAttempts: number): string {
+  if (attempt > 0) {
+    return ` (succeeded on retry ${attempt})`;
+  }
+  return "";
+}
+
+/**
+ * Calculate failure info string for logging
+ *
+ * @param attempt - Current attempt number (0-indexed)
+ * @param totalAttempts - Total number of attempts
+ * @returns Formatted failure info string
+ *
+ * @example
+ * ```typescript
+ * getFailureInfo(1, 2); // " after 2 attempts"
+ * getFailureInfo(0, 1); // ""
+ * ```
+ */
+export function getFailureInfo(attempt: number, _totalAttempts: number): string {
+  if (attempt > 0) {
+    return ` after ${attempt + 1} attempts`;
+  }
+  return "";
+}

package/src/infrastructure/utils/helpers/error-helpers.util.ts

@@ -63,24 +63,3 @@ export function formatErrorMessage(error: unknown, context: string): string {
   return `${context}: ${getErrorMessage(error)}`;
 }
 
-/**
- * Extract error name (for Error instances)
- * Returns undefined for non-Error types
- *
- * @param error - The error to extract name from
- * @returns The error name or undefined
- */
-export function getErrorName(error: unknown): string | undefined {
-  return error instanceof Error ? error.name : undefined;
-}
-
-/**
- * Extract error stack trace
- * Returns undefined for non-Error types
- *
- * @param error - The error to extract stack from
- * @returns The error stack trace or undefined
- */
-export function getErrorStack(error: unknown): string | undefined {
-  return error instanceof Error ? error.stack : undefined;
-}

package/src/infrastructure/utils/helpers/index.ts

@@ -1,7 +1,8 @@
 /**
  * Helper Utilities - Centralized Exports
- * Re-exports all helper utilities from submodules
  */
 
 export * from './timing-helpers.util';
 export * from './object-helpers.util';
+export * from './calculation-helpers.util';
+export * from './error-helpers.util';

package/src/infrastructure/utils/input-preprocessor.util.ts

@@ -173,9 +173,7 @@ export async function preprocessInput(
 
     if (failedUploads.length > 0) {
       const successCount = individualUploadResults.length - failedUploads.length;
-      const errorMessages = failedUploads.map((r) =>
-        r.status === 'rejected' ? getErrorMessage(r.reason) : 'Unknown error'
-      );
+      const errorMessages = failedUploads.map((r) => getErrorMessage(r.reason));
       generationLogCollector.error(sessionId, TAG, `Individual uploads: ${successCount}/${individualUploadResults.length} succeeded`, { errors: errorMessages });
       throw new Error(classifyUploadError(errorMessages[0]));
     }

package/src/infrastructure/utils/pricing/fal-pricing.util.ts

@@ -47,7 +47,25 @@ export function calculateCreditsFromConfig(
   duration: number,
   resolution: string,
 ): number {
-  const costPerSec = config.pricing.costPerSecond[resolution] ?? 0;
+  // Validate config structure before accessing nested properties
+  if (
+    !config ||
+    typeof config !== "object" ||
+    !config.pricing ||
+    typeof config.pricing !== "object" ||
+    !config.pricing.costPerSecond ||
+    typeof config.pricing.costPerSecond !== "object"
+  ) {
+    throw new Error("Invalid VideoModelConfig: pricing structure is missing or invalid");
+  }
+
+  const costPerSecondMap = config.pricing.costPerSecond;
+  const costPerSec = costPerSecondMap[resolution] ?? 0;
+
+  if (typeof costPerSec !== "number" || costPerSec < 0) {
+    throw new Error(`Invalid cost per second for resolution "${resolution}": must be a non-negative number`);
+  }
+
   const cost = costPerSec * duration;
   return Math.max(1, Math.ceil((cost * MARKUP) / CREDIT_PRICE));
 }

package/src/infrastructure/utils/type-guards/index.ts

@@ -1,8 +1,6 @@
 /**
  * Type Guards - Centralized Exports
- * Re-exports all type guard utilities from submodules
  */
 
-export * from './constants';
 export * from './model-type-guards.util';
 export * from './validation-guards.util';

package/src/infrastructure/utils/type-guards/validation-guards.util.ts

@@ -22,7 +22,10 @@ export function isValidBase64Image(value: unknown): boolean {
 
   // Check data URI prefix - use direct check instead of type guard to avoid type narrowing issues
   if (value.startsWith("data:image/")) {
-    const base64Part = value.split("base64,")[1];
+    const parts = value.split("base64,");
+    // Ensure split produced at least 2 parts and the second part exists
+    if (parts.length < 2) return false;
+    const base64Part = parts[1];
     if (!base64Part) return false;
     return base64Part.length >= MIN_BASE64_IMAGE_LENGTH;
   }

package/src/init/createAiProviderInitModule.ts

@@ -4,7 +4,7 @@
  */
 
 import { providerRegistry } from '@umituz/react-native-ai-generation-content';
-import { falProvider } from '../infrastructure/services';
+import { falProvider } from '../infrastructure/services/fal-provider';
 
 /**
  * InitModule interface (from @umituz/react-native-design-system)
@@ -79,6 +79,8 @@ export function createAiProviderInitModule(
 
         return Promise.resolve(true);
       } catch (error) {
+        // Use console.error for init module failures (logging may not be initialized yet)
+        // This is a critical startup error, so we want it visible
         console.error('[AiProviderInitModule] Initialization failed:', error);
         throw error;
       }

package/src/init/initializeFalProvider.ts

@@ -4,7 +4,7 @@
  */
 
 import { providerRegistry } from '@umituz/react-native-ai-generation-content';
-import { falProvider } from '../infrastructure/services';
+import { falProvider } from '../infrastructure/services/fal-provider';
 
 /**
  * Initializes FAL provider and registers it with providerRegistry in one call.

package/src/exports/domain.ts

@@ -1,51 +0,0 @@
-/**
- * Domain Layer Exports
- */
-
-export type {
-  FalConfig,
-  FalModel,
-  FalModelType,
-  FalModelPricing,
-  FalJobInput,
-  FalJobResult,
-  FalLogEntry,
-  FalQueueStatus,
-  FalSubscribeOptions,
-} from "../domain/entities/fal.types";
-
-export { FalErrorType } from "../domain/entities/error.types";
-export type {
-  FalErrorCategory,
-  FalErrorInfo,
-  FalErrorMessages,
-} from "../domain/entities/error.types";
-
-export type { FalModelConfig } from "../domain/types/fal-model-config.types";
-
-export type {
-  UpscaleOptions,
-  PhotoRestoreOptions,
-  FaceSwapOptions,
-  ImageToImagePromptConfig,
-  RemoveBackgroundOptions,
-  RemoveObjectOptions,
-  ReplaceBackgroundOptions,
-  VideoFromImageOptions,
-  TextToVideoOptions,
-  TextToVoiceOptions,
-  ImageFeatureType,
-  VideoFeatureType,
-  AIProviderConfig,
-  AIJobStatusType,
-  AILogEntry,
-  JobSubmission,
-  JobStatus,
-  ProviderProgressInfo,
-  SubscribeOptions,
-  RunOptions,
-  ProviderCapabilities,
-  ImageFeatureInputData,
-  VideoFeatureInputData,
-  IAIProvider,
-} from "../domain/types";

package/src/exports/infrastructure.ts

@@ -1,76 +0,0 @@
-/**
- * Infrastructure Layer Exports
- */
-
-export {
-  FalProvider,
-  falProvider,
-  NSFWContentError,
-  cleanupRequestStore,
-  stopAutomaticCleanup,
-} from "../infrastructure/services";
-export type { FalProviderType, ActiveRequest } from "../infrastructure/services";
-
-export {
-  mapFalError,
-  parseFalError,
-  isFalErrorRetryable,
-} from "../infrastructure/utils";
-
-export {
-  getErrorMessage,
-  getErrorMessageOr,
-  formatErrorMessage,
-} from "../infrastructure/utils/helpers/error-helpers.util";
-
-export {
-  IMAGE_URL_FIELDS,
-  isImageField,
-} from "../infrastructure/utils/constants/image-fields.constants";
-export type {
-  ImageUrlField,
-} from "../infrastructure/utils/constants/image-fields.constants";
-
-export {
-  isDataUri,
-  isBase64DataUri,
-  extractMimeType,
-  extractBase64Content,
-} from "../infrastructure/utils/validators/data-uri-validator.util";
-export {
-  isEmptyString,
-  isNonEmptyString,
-  isString,
-} from "../infrastructure/utils/validators/string-validator.util";
-
-export {
-  isFalModelType,
-  isModelType,
-  isFalErrorType,
-  isValidBase64Image,
-  isValidApiKey,
-  isValidModelId,
-  isValidPrompt,
-  isValidTimeout,
-  isValidRetryCount,
-} from "../infrastructure/utils";
-
-export {
-  formatImageDataUri,
-  extractBase64,
-  getDataUriExtension,
-  uploadToFalStorage,
-  uploadMultipleToFalStorage,
-  buildErrorMessage,
-  isDefined,
-  removeNullish,
-  generateUniqueId,
-  sleep,
-} from "../infrastructure/utils";
-
-export {
-  calculateVideoCredits,
-  calculateImageCredits,
-  calculateCreditsFromConfig,
-} from "../infrastructure/utils";
-export type { GenerationResolution } from "../infrastructure/utils";

package/src/exports/presentation.ts

@@ -1,14 +0,0 @@
-/**
- * Presentation Layer Exports
- */
-
-export { useFalGeneration } from "../presentation/hooks";
-export type { UseFalGenerationOptions, UseFalGenerationResult } from "../presentation/hooks";
-
-export {
-  FalGenerationStateManager,
-} from "../infrastructure/utils/fal-generation-state-manager.util";
-export type {
-  GenerationState,
-  GenerationStateOptions,
-} from "../infrastructure/utils/fal-generation-state-manager.util";

package/src/infrastructure/services/index.ts

@@ -1,13 +0,0 @@
-/**
- * Services Index
- */
-
-export { FalProvider, falProvider } from "./fal-provider";
-export type { FalProvider as FalProviderType } from "./fal-provider";
-export { NSFWContentError } from "./nsfw-content-error";
-
-export {
-  cleanupRequestStore,
-  stopAutomaticCleanup,
-} from "./request-store";
-export type { ActiveRequest } from "./request-store";

package/src/infrastructure/utils/index.ts

@@ -1,55 +0,0 @@
-/**
- * Utils Index
- */
-
-export {
-  mapFalError,
-  parseFalError,
-  isFalErrorRetryable,
-} from "./fal-error-handler.util";
-
-export {
-  isFalModelType,
-  isModelType,
-  isFalErrorType,
-  isValidBase64Image,
-  isValidApiKey,
-  isValidModelId,
-  isValidPrompt,
-  isValidTimeout,
-  isValidRetryCount,
-} from "./type-guards";
-
-export {
-  formatImageDataUri,
-  extractBase64,
-  getDataUriExtension,
-} from "./image-helpers.util";
-
-export {
-  uploadToFalStorage,
-  uploadMultipleToFalStorage,
-} from "./fal-storage.util";
-
-export {
-  buildErrorMessage,
-  isDefined,
-  removeNullish,
-  generateUniqueId,
-  sleep,
-} from "./helpers";
-
-export { preprocessInput } from "./input-preprocessor.util";
-
-export { generationLogCollector } from "./log-collector";
-export type { LogEntry } from "./log-collector";
-
-export { FalGenerationStateManager } from "./fal-generation-state-manager.util";
-export type { GenerationState } from "./fal-generation-state-manager.util";
-
-export {
-  calculateVideoCredits,
-  calculateImageCredits,
-  calculateCreditsFromConfig,
-} from "./pricing/fal-pricing.util";
-export type { GenerationResolution } from "./pricing/fal-pricing.util";

package/src/infrastructure/utils/parsers/index.ts

@@ -1,6 +0,0 @@
-/**
- * Parser Utilities
- */
-
-export * from './json-parsers.util';
-export * from './object-transformers.util';

package/src/infrastructure/utils/parsers/json-parsers.util.ts

@@ -1,73 +0,0 @@
-/**
- * JSON Parser Utilities
- * Safe JSON parsing and validation operations
- */
-
-import { getErrorMessage } from '../helpers/error-helpers.util';
-
-/**
- * Safely parse JSON with fallback
- */
-export function safeJsonParse<T = unknown>(
-  data: string,
-  fallback: T
-): T {
-  try {
-    return JSON.parse(data) as T;
-  } catch (error) {
-    console.warn(
-      '[json-parsers] Failed to parse JSON, using fallback:',
-      getErrorMessage(error),
-      { dataPreview: data.substring(0, 100) }
-    );
-    return fallback;
-  }
-}
-
-/**
- * Safely parse JSON with null fallback
- */
-export function safeJsonParseOrNull<T = unknown>(data: string): T | null {
-  try {
-    return JSON.parse(data) as T;
-  } catch (error) {
-    console.warn(
-      '[json-parsers] Failed to parse JSON, returning null:',
-      getErrorMessage(error),
-      { dataPreview: data.substring(0, 100) }
-    );
-    return null;
-  }
-}
-
-/**
- * Safely stringify object with fallback
- */
-export function safeJsonStringify(
-  data: unknown,
-  fallback: string
-): string {
-  try {
-    return JSON.stringify(data);
-  } catch (error) {
-    console.warn(
-      '[json-parsers] Failed to stringify object, using fallback:',
-      getErrorMessage(error),
-      { dataType: typeof data }
-    );
-    return fallback;
-  }
-}
-
-/**
- * Check if string is valid JSON
- */
-export function isValidJson(data: string): boolean {
-  try {
-    JSON.parse(data);
-    return true;
-  } catch {
-    // Don't log here - this is expected to fail for validation checks
-    return false;
-  }
-}

package/src/infrastructure/utils/parsers/object-transformers.util.ts

@@ -1,53 +0,0 @@
-/**
- * Object Transformer Utilities
- * Clone, merge, pick, and omit operations
- */
-
-/**
- * Deep clone object using JSON serialization
- * Throws on failure (circular references, non-serializable values)
- * No silent fallback - caller must handle errors explicitly
- */
-export function deepClone<T>(data: T): T {
-  const serialized = JSON.stringify(data);
-  return JSON.parse(serialized) as T;
-}
-
-/**
- * Merge objects with later objects overriding earlier ones
- */
-export function mergeObjects<T extends Record<string, unknown>>(
-  ...objects: Partial<T>[]
-): T {
-  return Object.assign({}, ...objects) as T;
-}
-
-/**
- * Pick specified properties from object
- */
-export function pickProperties<T extends Record<string, unknown>, K extends keyof T>(
-  obj: T,
-  keys: readonly K[]
-): Pick<T, K> {
-  const result = {} as Pick<T, K>;
-  for (const key of keys) {
-    if (key in obj) {
-      result[key] = obj[key];
-    }
-  }
-  return result;
-}
-
-/**
- * Omit specified properties from object
- */
-export function omitProperties<T extends Record<string, unknown>, K extends keyof T>(
-  obj: T,
-  keys: readonly K[]
-): Omit<T, K> {
-  const result = { ...obj };
-  for (const key of keys) {
-    delete result[key];
-  }
-  return result as Omit<T, K>;
-}

package/src/presentation/hooks/index.ts

@@ -1,6 +0,0 @@
-/**
- * Presentation Layer Hooks Index
- */
-
-export { useFalGeneration } from "./use-fal-generation";
-export type { UseFalGenerationOptions, UseFalGenerationResult } from "./use-fal-generation";