@umituz/react-native-ai-fal-provider 2.1.4 → 2.1.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-ai-fal-provider",
-  "version": "2.1.4",
+  "version": "2.1.6",
   "description": "FAL AI provider for React Native - implements IAIProvider interface for unified AI generation",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/exports/infrastructure.ts

@@ -7,8 +7,6 @@ export {
   falProvider,
   falModelsService,
   NSFWContentError,
-  cancelCurrentFalRequest,
-  hasRunningFalRequest,
   cleanupRequestStore,
   stopAutomaticCleanup,
 } from "../infrastructure/services";
@@ -45,7 +43,6 @@ export {
   uploadToFalStorage,
   uploadMultipleToFalStorage,
   formatNumber,
-  formatCurrency,
   formatBytes,
   formatDuration,
   truncateText,
@@ -55,10 +52,7 @@ export {
   isDefined,
   removeNullish,
   generateUniqueId,
-  debounce,
-  throttle,
   sleep,
-  retry,
 } from "../infrastructure/utils";
 
 export {
@@ -89,8 +83,5 @@ export {
   updateJobStatus,
 } from "../infrastructure/utils";
 
-export type {
-  FalJobMetadata,
-  IJobStorage,
-  InMemoryJobStorage,
-} from "../infrastructure/utils";
+export type { FalJobMetadata, IJobStorage } from "../infrastructure/utils";
+export { InMemoryJobStorage } from "../infrastructure/utils";

package/src/index.ts

@@ -16,4 +16,4 @@ export * from "./exports/presentation";
 export {
   createAiProviderInitModule,
   type AiProviderInitModuleConfig,
-} from './init';
+} from './init/createAiProviderInitModule';

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

@@ -10,7 +10,7 @@ import { DEFAULT_FAL_CONFIG } from "./fal-provider.constants";
 import { mapFalStatusToJobStatus } from "./fal-status-mapper";
 import { validateNSFWContent } from "../validators/nsfw-validator";
 import { NSFWContentError } from "./nsfw-content-error";
-import { parseFalError } from "../utils/error-mapper";
+import { parseFalError } from "../utils/fal-error-handler.util";
 
 /**
  * Handle FAL subscription with timeout and cancellation

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

@@ -140,6 +140,7 @@ export class FalProvider implements IAIProvider {
     storeRequest(key, { promise, abortController, createdAt: Date.now() });
 
     // Execute the actual operation and resolve/reject the stored promise
+    // Note: This promise chain is not awaited - it runs independently
     executeWithCostTracking({
       tracker,
       model,
@@ -149,11 +150,9 @@ export class FalProvider implements IAIProvider {
     })
       .then((res) => {
         resolvePromise(res.result);
-        return res.result;
       })
       .catch((error) => {
         rejectPromise(error);
-        throw error;
       })
       .finally(() => {
         try {

package/src/infrastructure/services/index.ts

@@ -2,8 +2,6 @@
  * Services Index
  */
 
-import { falProvider } from "./fal-provider";
-
 export { FalProvider, falProvider } from "./fal-provider";
 export type { FalProvider as FalProviderType } from "./fal-provider";
 export { falModelsService, type FalModelConfig, type ModelSelectionResult } from "./fal-models.service";
@@ -21,17 +19,3 @@ export {
   stopAutomaticCleanup,
 } from "./request-store";
 export type { ActiveRequest } from "./request-store";
-
-/**
- * Cancel the current running FAL request
- */
-export function cancelCurrentFalRequest(): void {
-  falProvider.cancelCurrentRequest();
-}
-
-/**
- * Check if there's a running FAL request
- */
-export function hasRunningFalRequest(): boolean {
-  return falProvider.hasRunningRequest();
-}

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

@@ -86,11 +86,11 @@ export function storeRequest<T>(key: string, request: ActiveRequest<T>): void {
   const maxRetries = 10;
   let retries = 0;
 
-  // Spin-wait with small delay between retries
+  // Spin-wait loop (synchronous)
+  // Note: Does NOT yield to event loop - tight loop
+  // In practice, this rarely loops due to single-threaded nature of React Native
   while (!acquireLock() && retries < maxRetries) {
     retries++;
-    // Yield to event loop between retries
-    // In practice, this rarely loops due to single-threaded nature
   }
 
   if (retries >= maxRetries) {

package/src/infrastructure/utils/collections/array-sorters.util.ts

@@ -5,6 +5,7 @@
 
 /**
  * Sort array by date property (descending - newest first)
+ * Invalid dates are sorted to the end
  */
 export function sortByDateDescending<T>(
   items: readonly T[],
@@ -13,12 +14,19 @@ export function sortByDateDescending<T>(
   return [...items].sort((a, b) => {
     const timeA = new Date(a[dateProperty] as unknown as string).getTime();
     const timeB = new Date(b[dateProperty] as unknown as string).getTime();
+
+    // Handle invalid dates - NaN should sort to end
+    if (isNaN(timeA) && isNaN(timeB)) return 0;
+    if (isNaN(timeA)) return 1; // a goes to end
+    if (isNaN(timeB)) return -1; // b goes to end
+
     return timeB - timeA;
   });
 }
 
 /**
  * Sort array by date property (ascending - oldest first)
+ * Invalid dates are sorted to the end
  */
 export function sortByDateAscending<T>(
   items: readonly T[],
@@ -27,12 +35,19 @@ export function sortByDateAscending<T>(
   return [...items].sort((a, b) => {
     const timeA = new Date(a[dateProperty] as unknown as string).getTime();
     const timeB = new Date(b[dateProperty] as unknown as string).getTime();
+
+    // Handle invalid dates - NaN should sort to end
+    if (isNaN(timeA) && isNaN(timeB)) return 0;
+    if (isNaN(timeA)) return 1; // a goes to end
+    if (isNaN(timeB)) return -1; // b goes to end
+
     return timeA - timeB;
   });
 }
 
 /**
  * Sort array by number property (descending)
+ * NaN and Infinity values are sorted to the end
  */
 export function sortByNumberDescending<T>(
   items: readonly T[],
@@ -41,12 +56,22 @@ export function sortByNumberDescending<T>(
   return [...items].sort((a, b) => {
     const numA = a[numberProperty] as unknown as number;
     const numB = b[numberProperty] as unknown as number;
+
+    // Handle NaN and Infinity
+    const isAValid = isFinite(numA);
+    const isBValid = isFinite(numB);
+
+    if (!isAValid && !isBValid) return 0;
+    if (!isAValid) return 1; // a goes to end
+    if (!isBValid) return -1; // b goes to end
+
     return numB - numA;
   });
 }
 
 /**
  * Sort array by number property (ascending)
+ * NaN and Infinity values are sorted to the end
  */
 export function sortByNumberAscending<T>(
   items: readonly T[],
@@ -55,6 +80,15 @@ export function sortByNumberAscending<T>(
   return [...items].sort((a, b) => {
     const numA = a[numberProperty] as unknown as number;
     const numB = b[numberProperty] as unknown as number;
+
+    // Handle NaN and Infinity
+    const isAValid = isFinite(numA);
+    const isBValid = isFinite(numB);
+
+    if (!isAValid && !isBValid) return 0;
+    if (!isAValid) return 1; // a goes to end
+    if (!isBValid) return -1; // b goes to end
+
     return numA - numB;
   });
 }

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

@@ -5,4 +5,3 @@
 
 export * from './array-filters.util';
 export * from './array-sorters.util';
-export * from './array-reducers.util';

package/src/infrastructure/utils/cost-tracker.ts

@@ -9,9 +9,11 @@ import type {
   ModelCostInfo,
 } from "../../domain/entities/cost-tracking.types";
 import { findModelById } from "../../domain/constants/default-models.constants";
-import { filterByProperty, filterByTimeRange } from "./collection-filters.util";
+import { filterByProperty, filterByTimeRange } from "./collections";
 
-interface CostSummary {
+export type { GenerationCost } from "../../domain/entities/cost-tracking.types";
+
+export interface CostSummary {
   totalEstimatedCost: number;
   totalActualCost: number;
   currency: string;

package/src/infrastructure/utils/date-format.util.ts

@@ -4,61 +4,27 @@
  */
 
 /**
- * Format date to locale string
+ * Validate that a date is valid
  */
-export function formatDate(date: Date | string, locale: string = "en-US"): string {
-  const dateObj = typeof date === "string" ? new Date(date) : date;
-  return dateObj.toLocaleDateString(locale, {
-    year: "numeric",
-    month: "short",
-    day: "numeric",
-  });
+function isValidDate(date: Date): boolean {
+  return date instanceof Date && !isNaN(date.getTime());
 }
 
 /**
- * Format date and time to locale string
+ * Format date to locale string
+ * @throws {Error} if date is invalid
  */
-export function formatDateTime(date: Date | string, locale: string = "en-US"): string {
+export function formatDate(date: Date | string, locale: string = "en-US"): string {
   const dateObj = typeof date === "string" ? new Date(date) : date;
-  return dateObj.toLocaleString(locale, {
+
+  if (!isValidDate(dateObj)) {
+    const dateStr = typeof date === "string" ? date : date.toISOString();
+    throw new Error(`Invalid date: ${dateStr}`);
+  }
+
+  return dateObj.toLocaleDateString(locale, {
     year: "numeric",
     month: "short",
     day: "numeric",
-    hour: "2-digit",
-    minute: "2-digit",
   });
 }
-
-/**
- * Format relative time (e.g., "2 hours ago")
- */
-export function formatRelativeTime(date: Date | string, locale: string = "en-US"): string {
-  const dateObj = typeof date === "string" ? new Date(date) : date;
-  const now = new Date();
-  const diffMs = now.getTime() - dateObj.getTime();
-  const diffSec = Math.floor(diffMs / 1000);
-  const diffMin = Math.floor(diffSec / 60);
-  const diffHour = Math.floor(diffMin / 60);
-  const diffDay = Math.floor(diffHour / 24);
-
-  const rtf = new Intl.RelativeTimeFormat(locale, { numeric: "auto" });
-
-  if (diffSec < 60) {
-    return rtf.format(-diffSec, "second");
-  }
-  if (diffMin < 60) {
-    return rtf.format(-diffMin, "minute");
-  }
-  if (diffHour < 24) {
-    return rtf.format(-diffHour, "hour");
-  }
-  if (diffDay < 30) {
-    return rtf.format(-diffDay, "day");
-  }
-  if (diffDay < 365) {
-    const months = Math.floor(diffDay / 30);
-    return rtf.format(-months, "month");
-  }
-  const years = Math.floor(diffDay / 365);
-  return rtf.format(-years, "year");
-}

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

@@ -5,7 +5,7 @@
 
 import type { FalErrorInfo, FalErrorCategory, FalErrorType } from "../../domain/entities/error.types";
 import { FalErrorType as ErrorTypeEnum } from "../../domain/entities/error.types";
-import { safeJsonParseOrNull } from "./data-parsers.util";
+import { safeJsonParseOrNull } from "./parsers";
 
 const STATUS_CODES = ["400", "401", "402", "403", "404", "422", "429", "500", "502", "503", "504"];
 

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

@@ -43,9 +43,48 @@ export async function uploadToFalStorage(base64: string): Promise<string> {
 
 /**
  * Upload multiple images to FAL storage in parallel
+ * Uses Promise.allSettled to handle partial failures gracefully
+ * @throws {Error} if any upload fails, with details about all failures
+ * Note: Successful uploads before the first failure are NOT cleaned up automatically
+ * as FAL storage doesn't provide a delete API. Monitor orphaned uploads externally.
  */
 export async function uploadMultipleToFalStorage(
   images: string[],
 ): Promise<string[]> {
-  return Promise.all(images.map(uploadToFalStorage));
+  const results = await Promise.allSettled(images.map(uploadToFalStorage));
+
+  const successfulUploads: string[] = [];
+  const failures: Array<{ index: number; error: unknown }> = [];
+
+  results.forEach((result, index) => {
+    if (result.status === 'fulfilled') {
+      successfulUploads.push(result.value);
+    } else {
+      failures.push({ index, error: result.reason });
+    }
+  });
+
+  // If any upload failed, throw detailed error
+  if (failures.length > 0) {
+    const errorMessage = failures
+      .map(({ index, error }) =>
+        `Image ${index}: ${error instanceof Error ? error.message : String(error)}`
+      )
+      .join('; ');
+
+    // Log warning about orphaned uploads
+    if (successfulUploads.length > 0) {
+      console.warn(
+        `[fal-storage] ${successfulUploads.length} upload(s) succeeded before failure. ` +
+        'These files remain in FAL storage and may need manual cleanup:',
+        successfulUploads
+      );
+    }
+
+    throw new Error(
+      `Failed to upload ${failures.length} of ${images.length} image(s): ${errorMessage}`
+    );
+  }
+
+  return successfulUploads;
 }

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

@@ -5,4 +5,3 @@
 
 export * from './timing-helpers.util';
 export * from './object-helpers.util';
-export * from './function-helpers.util';

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

@@ -1,89 +1,11 @@
 /**
  * Timing Helper Utilities
- * Debounce, throttle, sleep, and retry operations
+ * Sleep utility for async delays
  */
 
-/**
- * Create debounced function
- */
-export function debounce<T extends (...args: never[]) => void>(
-  func: T,
-  wait: number
-): (...args: Parameters<T>) => void {
-  let timeoutId: ReturnType<typeof setTimeout> | null = null;
-
-  return function debounced(...args: Parameters<T>) {
-    if (timeoutId) {
-      clearTimeout(timeoutId);
-    }
-    timeoutId = setTimeout(() => {
-      func(...args);
-    }, wait);
-  };
-}
-
-/**
- * Create throttled function
- */
-export function throttle<T extends (...args: never[]) => void>(
-  func: T,
-  limit: number
-): (...args: Parameters<T>) => void {
-  let inThrottle = false;
-
-  return function throttled(...args: Parameters<T>) {
-    if (!inThrottle) {
-      func(...args);
-      inThrottle = true;
-      setTimeout(() => {
-        inThrottle = false;
-      }, limit);
-    }
-  };
-}
-
 /**
  * Sleep for specified milliseconds
  */
 export function sleep(ms: number): Promise<void> {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
-
-/**
- * Retry function with exponential backoff
- */
-export async function retry<T>(
-  func: () => Promise<T>,
-  options: {
-    maxRetries?: number;
-    baseDelay?: number;
-    maxDelay?: number;
-    shouldRetry?: (error: unknown) => boolean;
-  } = {}
-): Promise<T> {
-  const {
-    maxRetries = 3,
-    baseDelay = 1000,
-    maxDelay = 10000,
-    shouldRetry = () => true,
-  } = options;
-
-  for (let attempt = 0; attempt <= maxRetries; attempt++) {
-    try {
-      return await func();
-    } catch (error) {
-      // On last attempt or non-retryable error, throw immediately
-      if (attempt === maxRetries || !shouldRetry(error)) {
-        throw error;
-      }
-
-      // Calculate exponential backoff delay
-      const delay = Math.min(baseDelay * Math.pow(2, attempt), maxDelay);
-      await sleep(delay);
-    }
-  }
-
-  // This line is unreachable but required by TypeScript
-  // The loop always returns or throws on the last iteration
-  throw new Error('Retry loop completed without result (should not happen)');
-}

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

@@ -15,20 +15,24 @@ export function formatImageDataUri(base64: string): string {
 
 /**
  * Extract base64 from data URI
+ * Uses indexOf instead of split to handle edge cases where comma might appear in base64
  */
 export function extractBase64(dataUri: string): string {
   if (!dataUri.startsWith("data:")) {
     return dataUri;
   }
 
-  const parts = dataUri.split(",");
-  if (parts.length < 2) {
-    throw new Error(`Invalid data URI format: ${dataUri}`);
+  // Find the first comma which separates header from data
+  const commaIndex = dataUri.indexOf(",");
+  if (commaIndex === -1) {
+    throw new Error(`Invalid data URI format (no comma separator): ${dataUri.substring(0, 50)}...`);
   }
 
-  const base64Part = parts[1];
+  // Extract everything after the first comma
+  const base64Part = dataUri.substring(commaIndex + 1);
+
   if (!base64Part || base64Part.length === 0) {
-    throw new Error(`Empty base64 data in URI: ${dataUri}`);
+    throw new Error(`Empty base64 data in URI: ${dataUri.substring(0, 50)}...`);
   }
 
   return base64Part;

package/src/infrastructure/utils/index.ts

@@ -11,11 +11,7 @@ export {
   sortByDateAscending,
   sortByNumberDescending,
   sortByNumberAscending,
-  sumByProperty,
-  groupByProperty,
-  chunkArray,
-  distinctByProperty,
-} from "./collection-filters.util";
+} from "./collections";
 
 export {
   safeJsonParse,
@@ -23,16 +19,7 @@ export {
   safeJsonStringify,
   isValidJson,
   validateObjectStructure,
-  validateObjectArray,
-  parseNumber,
-  parseBoolean,
-  clampNumber,
-  roundToDecimals,
-  deepClone,
-  mergeObjects,
-  pickProperties,
-  omitProperties,
-} from "./data-parsers.util";
+} from "./parsers";
 
 export { categorizeFalError } from "./error-categorizer";
 export {
@@ -40,30 +27,16 @@ export {
   parseFalError,
   isFalErrorRetryable,
   extractStatusCode,
-} from "./error-mapper";
+} from "./fal-error-handler.util";
 
-export {
-  formatNumber,
-  formatCurrency,
-  formatBytes,
-  formatDuration,
-  formatPercentage,
-  formatDate,
-  formatDateTime,
-  formatRelativeTime,
-  truncateText,
-  capitalize,
-  toTitleCase,
-  toSlug,
-  formatList,
-  pluralize,
-  formatCount,
-} from "./formatting.util";
+export { formatDate } from "./date-format.util";
+export { formatNumber, formatBytes, formatDuration } from "./number-format.util";
+export { truncateText } from "./string-format.util";
 
 export {
   buildSingleImageInput,
   buildDualImageInput,
-} from "./input-builders.util";
+} from "./base-builders.util";
 
 export {
   isFalModelType,
@@ -75,7 +48,7 @@ export {
   isValidPrompt,
   isValidTimeout,
   isValidRetryCount,
-} from "./type-guards.util";
+} from "./type-guards";
 
 export {
   formatImageDataUri,
@@ -99,15 +72,13 @@ export {
   isDefined,
   removeNullish,
   generateUniqueId,
-  debounce,
-  throttle,
   sleep,
-  retry,
-  noop,
-  identity,
-  constant,
-} from "./general-helpers.util";
+} from "./helpers";
+
+export { preprocessInput } from "./input-preprocessor.util";
+export { validateInput } from "./input-validator.util";
 
+export type { FalJobMetadata } from "./job-metadata";
 export {
   createJobMetadata,
   updateJobMetadata,
@@ -125,36 +96,22 @@ export {
   getCompletedJobs,
 } from "./job-metadata";
 
-export type { FalJobMetadata } from "./job-metadata";
-
+export type { IJobStorage } from "./job-storage";
 export {
+  InMemoryJobStorage,
   saveJobMetadata,
   loadJobMetadata,
   deleteJobMetadata,
+  updateJobStatus,
   loadAllJobs,
   cleanupOldJobs,
   getJobsByModel,
   getJobsByStatus,
-  updateJobStatus,
 } from "./job-storage";
 
-export type { IJobStorage, InMemoryJobStorage } from "./job-storage";
-
-export { CostTracker } from "./cost-tracker";
-
 export { executeWithCostTracking } from "./cost-tracking-executor.util";
+export { CostTracker } from "./cost-tracker";
+export type { CostSummary, GenerationCost } from "./cost-tracker";
 
-export { preprocessInput } from "./input-preprocessor.util";
-
-export {
-  validateInput,
-  type InputValidationError,
-  type ValidationError,
-} from "./input-validator.util";
-
-// FAL generation state manager
-export {
-  FalGenerationStateManager,
-  type GenerationState,
-  type GenerationStateOptions,
-} from "./fal-generation-state-manager.util";
+export { FalGenerationStateManager } from "./fal-generation-state-manager.util";
+export type { GenerationState } from "./fal-generation-state-manager.util";

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

@@ -90,18 +90,61 @@ export async function preprocessInput(
       throw new Error('image_urls array must contain at least one valid image URL');
     }
 
-    // Wait for all uploads and build the final array
-    // Tasks are already in correct order from the loop, no need to sort
-    const processedUrls = await Promise.all(
+    // Wait for all uploads using Promise.allSettled to handle failures gracefully
+    // This ensures all uploads complete before reporting errors
+    const uploadResults = await Promise.allSettled(
       uploadTasks.map((task) => Promise.resolve(task.url))
     );
 
+    const processedUrls: string[] = [];
+    const uploadErrors: string[] = [];
+
+    uploadResults.forEach((result, index) => {
+      if (result.status === 'fulfilled') {
+        processedUrls.push(result.value);
+      } else {
+        uploadErrors.push(
+          `Upload ${index} failed: ${result.reason instanceof Error ? result.reason.message : String(result.reason)}`
+        );
+      }
+    });
+
+    // If any uploads failed, throw with details
+    if (uploadErrors.length > 0) {
+      console.warn(
+        `[input-preprocessor] ${processedUrls.length} of ${uploadTasks.length} uploads succeeded. ` +
+        'Successful uploads remain in FAL storage.'
+      );
+      throw new Error(`Image upload failures:\n${uploadErrors.join('\n')}`);
+    }
+
     result.image_urls = processedUrls;
   }
 
   // Wait for ALL uploads to complete (both individual keys and array)
+  // Use Promise.allSettled to handle partial failures gracefully
   if (uploadPromises.length > 0) {
-    await Promise.all(uploadPromises);
+    const individualUploadResults = await Promise.allSettled(uploadPromises);
+
+    const failedUploads = individualUploadResults.filter(
+      (result) => result.status === 'rejected'
+    );
+
+    if (failedUploads.length > 0) {
+      const successCount = individualUploadResults.length - failedUploads.length;
+      console.warn(
+        `[input-preprocessor] ${successCount} of ${individualUploadResults.length} individual field uploads succeeded. ` +
+        'Successful uploads remain in FAL storage.'
+      );
+
+      const errorMessages = failedUploads.map((result) =>
+        result.status === 'rejected'
+          ? (result.reason instanceof Error ? result.reason.message : String(result.reason))
+          : 'Unknown error'
+      );
+
+      throw new Error(`Some image uploads failed:\n${errorMessages.join('\n')}`);
+    }
   }
 
   return result;

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

@@ -3,7 +3,7 @@
  * Validates input parameters before API calls
  */
 
-import { isValidModelId, isValidPrompt } from "./type-guards.util";
+import { isValidModelId, isValidPrompt } from "./type-guards";
 
 /**
  * Detect potentially malicious content in strings

package/src/infrastructure/utils/job-metadata/job-metadata-format.util.ts

@@ -7,12 +7,37 @@ import type { FalJobMetadata } from "./job-metadata.types";
 
 /**
  * Get job duration in milliseconds
+ * Returns null if job not completed or if dates are invalid
  */
 export function getJobDuration(metadata: FalJobMetadata): number | null {
   if (!metadata.completedAt) {
     return null;
   }
-  return new Date(metadata.completedAt).getTime() - new Date(metadata.createdAt).getTime();
+
+  const completedTime = new Date(metadata.completedAt).getTime();
+  const createdTime = new Date(metadata.createdAt).getTime();
+
+  // Validate both dates parsed correctly
+  if (isNaN(completedTime) || isNaN(createdTime)) {
+    console.warn(
+      '[job-metadata] Invalid date(s) in metadata:',
+      { completedAt: metadata.completedAt, createdAt: metadata.createdAt }
+    );
+    return null;
+  }
+
+  const duration = completedTime - createdTime;
+
+  // Sanity check: duration should be positive
+  if (duration < 0) {
+    console.warn(
+      '[job-metadata] Negative duration detected (completedAt < createdAt):',
+      { duration, completedAt: metadata.completedAt, createdAt: metadata.createdAt }
+    );
+    return null;
+  }
+
+  return duration;
 }
 
 /**

package/src/infrastructure/utils/job-metadata/job-metadata-queries.util.ts

@@ -5,8 +5,8 @@
 
 import type { FalJobMetadata } from "./job-metadata.types";
 import { isJobStale, isJobRunning, isJobCompleted } from "./job-metadata-lifecycle.util";
-import { sortByDateDescending, filterByPredicate } from "../collection-filters.util";
-import { safeJsonParseOrNull, validateObjectStructure } from "../data-parsers.util";
+import { sortByDateDescending, filterByPredicate } from "../collections";
+import { safeJsonParseOrNull, validateObjectStructure } from "../parsers";
 
 /**
  * Serialize job metadata for storage

package/src/infrastructure/utils/job-storage/job-storage-crud.util.ts

@@ -6,7 +6,7 @@
 import type { FalJobMetadata } from "../job-metadata";
 import { updateJobMetadata } from "../job-metadata";
 import type { IJobStorage } from "./job-storage-interface";
-import { safeJsonParseOrNull, safeJsonStringify } from "../data-parsers.util";
+import { safeJsonParseOrNull, safeJsonStringify } from "../parsers";
 
 /**
  * Save job metadata to storage

package/src/infrastructure/utils/job-storage/job-storage-queries.util.ts

@@ -6,7 +6,7 @@
 import type { FalJobMetadata } from "../job-metadata";
 import type { IJobStorage } from "./job-storage-interface";
 import { deleteJobMetadata } from "./job-storage-crud.util";
-import { safeJsonParseOrNull } from "../data-parsers.util";
+import { safeJsonParseOrNull } from "../parsers";
 
 /**
  * Load all jobs from storage

package/src/infrastructure/utils/number-format.util.ts

@@ -19,26 +19,42 @@ export function formatNumber(value: number, decimals: number = 2): string {
   return value.toFixed(decimals);
 }
 
-/**
- * Format currency amount
- */
-export function formatCurrency(amount: number, currency: string = "USD"): string {
-  const formatted = formatNumber(amount, 2);
-  return `${currency} ${formatted}`;
-}
-
 /**
  * Format bytes to human-readable size
+ * Handles edge cases: negative bytes, NaN, Infinity, extremely large values
  */
 export function formatBytes(bytes: number, decimals: number = 2): string {
-  if (bytes === 0) return "0 Bytes";
+  // Handle invalid inputs
+  if (!Number.isFinite(bytes) || Number.isNaN(bytes)) {
+    return "0 Bytes";
+  }
+
+  // Handle negative bytes
+  if (bytes < 0) {
+    return `-${formatBytes(-bytes, decimals)}`;
+  }
+
+  // Handle zero
+  if (bytes === 0) {
+    return "0 Bytes";
+  }
 
   const k = 1024;
   const dm = decimals < 0 ? 0 : decimals;
-  const sizes = ["Bytes", "KB", "MB", "GB", "TB", "PB"];
+  const sizes = ["Bytes", "KB", "MB", "GB", "TB", "PB", "EB", "ZB", "YB"];
   const i = Math.floor(Math.log(bytes) / Math.log(k));
 
-  return `${parseFloat((bytes / Math.pow(k, i)).toFixed(dm))} ${sizes[i]}`;
+  // Clamp index to valid range
+  const index = Math.min(i, sizes.length - 1);
+
+  // For extremely large values beyond our size array
+  if (index >= sizes.length - 1 && i > sizes.length - 1) {
+    const exponent = i - (sizes.length - 1);
+    const value = bytes / Math.pow(k, sizes.length - 1);
+    return `${parseFloat(value.toFixed(dm))} ${sizes[sizes.length - 1]} × ${k}^${exponent}`;
+  }
+
+  return `${parseFloat((bytes / Math.pow(k, index)).toFixed(dm))} ${sizes[index]}`;
 }
 
 /**
@@ -68,12 +84,3 @@ export function formatDuration(milliseconds: number): string {
     ? `${hours}h ${remainingMinutes}m`
     : `${hours}h`;
 }
-
-/**
- * Format percentage
- */
-export function formatPercentage(value: number, decimals: number = 1): string {
-  if (value < 0) return "0%";
-  if (value > 100) return "100%";
-  return `${formatNumber(value, decimals)}%`;
-}

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

@@ -6,5 +6,4 @@
 export * from './json-parsers.util';
 export * from './object-validators.util';
 export * from './value-parsers.util';
-export * from './number-helpers.util';
 export * from './object-transformers.util';

package/src/infrastructure/utils/string-format.util.ts

@@ -12,62 +12,3 @@ export function truncateText(text: string, maxLength: number): string {
   }
   return text.slice(0, maxLength - 3) + "...";
 }
-
-/**
- * Capitalize first letter of string
- */
-export function capitalize(text: string): string {
-  if (!text) return text;
-  return text.charAt(0).toUpperCase() + text.slice(1);
-}
-
-/**
- * Convert string to title case
- */
-export function toTitleCase(text: string): string {
-  return text
-    .toLowerCase()
-    .split(" ")
-    .map((word) => capitalize(word))
-    .join(" ");
-}
-
-/**
- * Convert string to slug
- */
-export function toSlug(text: string): string {
-  return text
-    .toLowerCase()
-    .trim()
-    .replace(/[^\w\s-]/g, "")
-    .replace(/[\s_-]+/g, "-")
-    .replace(/^-+|-+$/g, "");
-}
-
-/**
- * Format list of items with conjunction
- */
-export function formatList(items: readonly string[], conjunction: string = "and"): string {
-  if (items.length === 0) return "";
-  if (items.length === 1) return items[0] ?? "";
-  if (items.length === 2) return items.join(` ${conjunction} `);
-
-  const allButLast = items.slice(0, -1);
-  const last = items[items.length - 1];
-  return `${allButLast.join(", ")}, ${conjunction} ${last}`;
-}
-
-/**
- * Pluralize word based on count
- */
-export function pluralize(word: string, count: number): string {
-  if (count === 1) return word;
-  return `${word}s`;
-}
-
-/**
- * Format count with plural word
- */
-export function formatCount(word: string, count: number): string {
-  return `${count} ${pluralize(word, count)}`;
-}

package/src/presentation/hooks/use-fal-generation.ts

@@ -5,7 +5,7 @@
 
 import { useState, useCallback, useRef, useEffect } from "react";
 import { falProvider } from "../../infrastructure/services/fal-provider";
-import { mapFalError } from "../../infrastructure/utils/error-mapper";
+import { mapFalError } from "../../infrastructure/utils/fal-error-handler.util";
 import { FalGenerationStateManager } from "../../infrastructure/utils/fal-generation-state-manager.util";
 import type { FalJobInput, FalQueueStatus } from "../../domain/entities/fal.types";
 import type { FalErrorInfo } from "../../domain/entities/error.types";

package/src/infrastructure/utils/collection-filters.util.ts

@@ -1,9 +0,0 @@
-/**
- * Collection Filter Utilities
- * @deprecated This file is now split into smaller modules for better maintainability.
- * Import from './collections' submodules instead.
- *
- * This file re-exports all functions for backward compatibility.
- */
-
-export * from './collections';

package/src/infrastructure/utils/collections/array-reducers.util.ts

@@ -1,67 +0,0 @@
-/**
- * Array Reducer Utilities
- * Reduce, group, chunk, and aggregation operations
- */
-
-/**
- * Reduce array to sum of number property
- */
-export function sumByProperty<T>(
-  items: readonly T[],
-  numberProperty: keyof T
-): number {
-  return items.reduce((sum, item) => {
-    const value = item[numberProperty] as unknown as number;
-    return sum + (typeof value === "number" ? value : 0);
-  }, 0);
-}
-
-/**
- * Group array by property value
- */
-export function groupByProperty<T>(
-  items: readonly T[],
-  property: keyof T
-): Map<unknown, T[]> {
-  const groups = new Map<unknown, T[]>();
-  for (const item of items) {
-    const key = item[property];
-    const existing = groups.get(key);
-    if (existing) {
-      existing.push(item);
-    } else {
-      groups.set(key, [item]);
-    }
-  }
-  return groups;
-}
-
-/**
- * Chunk array into smaller arrays of specified size
- */
-export function chunkArray<T>(items: readonly T[], chunkSize: number): T[][] {
-  const result: T[][] = [];
-  for (let i = 0; i < items.length; i += chunkSize) {
-    result.push([...items.slice(i, i + chunkSize)]);
-  }
-  return result;
-}
-
-/**
- * Get distinct values of a property from array
- */
-export function distinctByProperty<T>(
-  items: readonly T[],
-  property: keyof T
-): unknown[] {
-  const seen = new Set<unknown>();
-  const result: unknown[] = [];
-  for (const item of items) {
-    const value = item[property];
-    if (!seen.has(value)) {
-      seen.add(value);
-      result.push(value);
-    }
-  }
-  return result;
-}

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

@@ -1,9 +0,0 @@
-/**
- * Data Parser Utilities
- * @deprecated This file is now split into smaller modules for better maintainability.
- * Import from './parsers' submodules instead.
- *
- * This file re-exports all functions for backward compatibility.
- */
-
-export * from './parsers';

package/src/infrastructure/utils/error-mapper.ts

@@ -1,24 +0,0 @@
-/**
- * FAL Error Mapper - Maps errors to user-friendly info
- *
- * @deprecated This module is a re-export for backward compatibility.
- * Import directly from './fal-error-handler.util' instead.
- *
- * This module re-exports error handling functions from the unified
- * fal-error-handler.util module for backward compatibility.
- *
- * @example
- * // Instead of:
- * import { mapFalError } from './error-mapper';
- *
- * // Use:
- * import { mapFalError } from './fal-error-handler.util';
- */
-
-export {
-  mapFalError,
-  parseFalError,
-  isFalErrorRetryable,
-  categorizeFalError,
-  extractStatusCode,
-} from "./fal-error-handler.util";

package/src/infrastructure/utils/formatting.util.ts

@@ -1,31 +0,0 @@
-/**
- * Formatting Utilities
- * Common formatting functions for display and data presentation
- *
- * This module re-exports formatting utilities from specialized modules
- * for better organization and maintainability.
- */
-
-export {
-  formatDate,
-  formatDateTime,
-  formatRelativeTime,
-} from "./date-format.util";
-
-export {
-  formatNumber,
-  formatCurrency,
-  formatBytes,
-  formatDuration,
-  formatPercentage,
-} from "./number-format.util";
-
-export {
-  truncateText,
-  capitalize,
-  toTitleCase,
-  toSlug,
-  formatList,
-  pluralize,
-  formatCount,
-} from "./string-format.util";

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

@@ -1,9 +0,0 @@
-/**
- * General Helper Utilities
- * @deprecated This file is now split into smaller modules for better maintainability.
- * Import from './helpers' submodules instead.
- *
- * This file re-exports all functions for backward compatibility.
- */
-
-export * from './helpers';

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

@@ -1,25 +0,0 @@
-/**
- * Function Helper Utilities
- * Common functional programming helpers
- */
-
-/**
- * No-op function
- */
-export function noop(): void {
-  // Intentionally empty
-}
-
-/**
- * Identity function
- */
-export function identity<T>(value: T): T {
-  return value;
-}
-
-/**
- * Constant function (returns same value regardless of input)
- */
-export function constant<T>(value: T): () => T {
-  return () => value;
-}

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

@@ -1,6 +0,0 @@
-/**
- * FAL Input Builders - Constructs FAL API input from normalized data
- * Provider-agnostic: accepts prompt config as parameter, not imported
- */
-
-export * from "./base-builders.util";

package/src/infrastructure/utils/parsers/number-helpers.util.ts

@@ -1,19 +0,0 @@
-/**
- * Number Helper Utilities
- * Number manipulation and formatting
- */
-
-/**
- * Clamp number between min and max
- */
-export function clampNumber(value: number, min: number, max: number): number {
-  return Math.min(Math.max(value, min), max);
-}
-
-/**
- * Round to decimal places
- */
-export function roundToDecimals(value: number, decimals: number): number {
-  const multiplier = Math.pow(10, decimals);
-  return Math.round(value * multiplier) / multiplier;
-}

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

@@ -1,9 +0,0 @@
-/**
- * Type Guards and Validation Utilities
- * @deprecated This file is now split into smaller modules for better maintainability.
- * Import from './type-guards' submodules instead.
- *
- * This file re-exports all functions for backward compatibility.
- */
-
-export * from './type-guards';

package/src/infrastructure/validators/index.ts

@@ -1,6 +0,0 @@
-/**
- * Validators Module
- * Exports all validator functions
- */
-
-export { validateNSFWContent } from "./nsfw-validator";

package/src/init/index.ts

@@ -1,10 +0,0 @@
-/**
- * AI Provider Init Module
- * Provides factory for creating app initialization modules
- */
-
-export {
-  createAiProviderInitModule,
-  type AiProviderInitModuleConfig,
-  type InitModule,
-} from './createAiProviderInitModule';