@umituz/react-native-ai-fal-provider 3.2.51 → 3.2.53

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

@@ -1,168 +0,0 @@
-/**
- * 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

@@ -1,65 +0,0 @@
-/**
- * Error Helper Utilities
- * Centralized error message extraction and formatting
- *
- * This utility eliminates the repeated pattern:
- * `error instanceof Error ? error.message : String(error)`
- * which appeared 8 times across 6 files in the codebase.
- */
-
-/**
- * Extract error message from any error type
- * Handles Error instances, strings, and unknown types
- *
- * @param error - The error to extract message from
- * @returns The error message as a string
- *
- * @example
- * ```typescript
- * try {
- *   await riskyOperation();
- * } catch (error) {
- *   console.error('Operation failed:', getErrorMessage(error));
- * }
- * ```
- */
-export function getErrorMessage(error: unknown): string {
-  return error instanceof Error ? error.message : String(error);
-}
-
-/**
- * Extract error message with fallback
- * Returns fallback if error message is empty or whitespace-only
- *
- * @param error - The error to extract message from
- * @param fallback - Fallback message if error message is empty
- * @returns The error message or fallback
- *
- * @example
- * ```typescript
- * const message = getErrorMessageOr(error, 'An unknown error occurred');
- * ```
- */
-export function getErrorMessageOr(error: unknown, fallback: string): string {
-  const message = getErrorMessage(error);
-  return message && message.trim().length > 0 ? message : fallback;
-}
-
-/**
- * Create error message with context prefix
- * Useful for adding operation context to error messages
- *
- * @param error - The error to extract message from
- * @param context - Context to prepend to the error message
- * @returns Formatted error message with context
- *
- * @example
- * ```typescript
- * throw new Error(formatErrorMessage(error, 'Failed to upload image'));
- * // Output: "Failed to upload image: Network timeout"
- * ```
- */
-export function formatErrorMessage(error: unknown, context: string): string {
-  return `${context}: ${getErrorMessage(error)}`;
-}
-

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

@@ -1,44 +0,0 @@
-/**
- * Object Helper Utilities
- * Object manipulation and validation helpers
- */
-
-/**
- * Build error message with context
- */
-export function buildErrorMessage(
-  type: string,
-  context: Record<string, unknown>
-): string {
-  const contextStr = Object.entries(context)
-    .map(([key, value]) => `${key}=${JSON.stringify(value)}`)
-    .join(", ");
-  return `${type}${contextStr ? ` (${contextStr})` : ""}`;
-}
-
-/**
- * Check if value is defined (not null or undefined)
- */
-export function isDefined<T>(value: T | null | undefined): value is T {
-  return value !== null && value !== undefined;
-}
-
-/**
- * Filter out null and undefined values from object
- */
-export function removeNullish<T extends Record<string, unknown>>(
-  obj: T
-): Partial<T> {
-  return Object.fromEntries(
-    Object.entries(obj).filter(([_, value]) => isDefined(value))
-  ) as Partial<T>;
-}
-
-/**
- * Generate unique ID
- */
-export function generateUniqueId(prefix: string = ""): string {
-  const timestamp = Date.now().toString(36);
-  const randomStr = Math.random().toString(36).substring(2, 9);
-  return prefix ? `${prefix}_${timestamp}${randomStr}` : `${timestamp}${randomStr}`;
-}

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

@@ -1,11 +0,0 @@
-/**
- * Timing Helper Utilities
- * Sleep utility for async delays
- */
-
-/**
- * Sleep for specified milliseconds
- */
-export function sleep(ms: number): Promise<void> {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}

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

@@ -1,56 +0,0 @@
-/**
- * Model Type Guards
- * Runtime type checking for model types
- */
-
-import type { FalModelType } from "../../../domain/entities/fal.types";
-import type { ModelType } from "../../../domain/types/model-selection.types";
-import { FalErrorType } from "../../../domain/entities/error.types";
-
-/**
- * Check if a string is a valid FalModelType
- */
-export function isFalModelType(value: unknown): value is FalModelType {
-  const validTypes: ReadonlyArray<FalModelType> = [
-    "text-to-image",
-    "text-to-video",
-    "text-to-voice",
-    "image-to-video",
-    "image-to-image",
-    "text-to-text",
-  ];
-  return typeof value === "string" && validTypes.includes(value as FalModelType);
-}
-
-/**
- * Check if a string is a valid ModelType
- */
-export function isModelType(value: unknown): value is ModelType {
-  const validTypes: ReadonlyArray<ModelType> = [
-    "text-to-image",
-    "text-to-video",
-    "image-to-video",
-    "text-to-voice",
-  ];
-  return typeof value === "string" && validTypes.includes(value as ModelType);
-}
-
-/**
- * Check if error is a FalErrorType
- */
-export function isFalErrorType(value: unknown): value is FalErrorType {
-  const validTypes: ReadonlyArray<FalErrorType> = [
-    FalErrorType.NETWORK,
-    FalErrorType.TIMEOUT,
-    FalErrorType.API_ERROR,
-    FalErrorType.VALIDATION,
-    FalErrorType.IMAGE_TOO_SMALL,
-    FalErrorType.CONTENT_POLICY,
-    FalErrorType.RATE_LIMIT,
-    FalErrorType.AUTHENTICATION,
-    FalErrorType.QUOTA_EXCEEDED,
-    FalErrorType.MODEL_NOT_FOUND,
-    FalErrorType.UNKNOWN,
-  ];
-  return typeof value === "string" && validTypes.includes(value as FalErrorType);
-}

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

@@ -1,101 +0,0 @@
-/**
- * Validation Guards
- * Runtime validation for values and formats
- */
-
-import {
-  MIN_BASE64_IMAGE_LENGTH,
-  MIN_MODEL_ID_LENGTH,
-  MAX_PROMPT_LENGTH,
-  MAX_TIMEOUT_MS,
-  MAX_RETRY_COUNT,
-} from './constants';
-import { isNonEmptyString } from '../validators/string-validator.util';
-
-/**
- * Validate base64 image string
- */
-export function isValidBase64Image(value: unknown): boolean {
-  if (typeof value !== "string") {
-    return false;
-  }
-
-  // Check data URI prefix - use direct check instead of type guard to avoid type narrowing issues
-  if (value.startsWith("data:image/")) {
-    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;
-  }
-
-  // Check if it's a valid base64 string with minimum length
-  const base64Pattern = /^[A-Za-z0-9+/]+=*$/;
-  return base64Pattern.test(value) && value.length >= MIN_BASE64_IMAGE_LENGTH;
-}
-
-/**
- * Validate API key format
- */
-export function isValidApiKey(value: unknown): boolean {
-  return typeof value === "string" && value.length > 0;
-}
-
-/**
- * Validate model ID format
- * Pattern: org/model or org/model/sub1/sub2/... (multiple path segments)
- * Allows dots for versions (e.g., v1.5) but prevents path traversal (..)
- * Examples:
- *   - xai/grok-imagine-video/text-to-video
- *   - fal-ai/minimax/hailuo-02/standard/image-to-video
- */
-const MODEL_ID_PATTERN = /^[a-zA-Z0-9-_]+\/[a-zA-Z0-9-_.]+(\/[a-zA-Z0-9-_.]+)*$/;
-
-export function isValidModelId(value: unknown): boolean {
-  if (typeof value !== "string") {
-    return false;
-  }
-
-  // Prevent path traversal attacks
-  if (value.includes('..')) {
-    return false;
-  }
-
-  // Ensure it doesn't start or end with dots
-  if (value.startsWith('.') || value.endsWith('.')) {
-    return false;
-  }
-
-  return MODEL_ID_PATTERN.test(value) && value.length >= MIN_MODEL_ID_LENGTH;
-}
-
-/**
- * Validate prompt string
- */
-export function isValidPrompt(value: unknown): boolean {
-  // Use type guard first, then check length
-  if (!isNonEmptyString(value)) return false;
-  return value.length <= MAX_PROMPT_LENGTH;
-}
-
-/**
- * Validate timeout value
- */
-export function isValidTimeout(value: unknown): boolean {
-  return typeof value === "number" && !isNaN(value) && isFinite(value) && value > 0 && value <= MAX_TIMEOUT_MS;
-}
-
-/**
- * Validate retry count
- */
-export function isValidRetryCount(value: unknown): boolean {
-  return (
-    typeof value === "number" &&
-    !isNaN(value) &&
-    isFinite(value) &&
-    Number.isInteger(value) &&
-    value >= 0 &&
-    value <= MAX_RETRY_COUNT
-  );
-}

package/src/infrastructure/utils/validators/data-uri-validator.util.ts

@@ -1,91 +0,0 @@
-/**
- * Data URI Validation Utilities
- * Centralized data URI format checking and validation
- *
- * Eliminates the duplicated pattern:
- * `value.startsWith("data:image/")`
- * which appeared in 4 different files.
- */
-
-/**
- * Check if value is a data URI (any type)
- *
- * @param value - Value to check
- * @returns Type guard indicating if the value is a data URI string
- *
- * @example
- * ```typescript
- * isDataUri("data:text/plain;base64,SGVsbG8="); // true
- * isDataUri("https://example.com/image.png"); // false
- * ```
- */
-export function isDataUri(value: unknown): value is string {
-  return typeof value === "string" && value.startsWith("data:");
-}
-
-/**
- * Check if value is an image data URI
- *
- * @param value - Value to check
- * @returns Type guard indicating if the value is an image data URI string
- *
- * @example
- * ```typescript
- * isImageDataUri("data:image/png;base64,iVBOR..."); // true
- * isImageDataUri("data:text/plain;base64,SGVsbG8="); // false
- * isImageDataUri("https://example.com/image.png"); // false
- * ```
- */
-export function isImageDataUri(value: unknown): value is string {
-  return typeof value === "string" && value.startsWith("data:image/");
-}
-
-/**
- * Check if value is a base64-encoded data URI
- *
- * @param value - Value to check
- * @returns Type guard indicating if the value contains base64 encoding
- *
- * @example
- * ```typescript
- * isBase64DataUri("data:image/png;base64,iVBOR..."); // true
- * isBase64DataUri("data:image/svg+xml,<svg>...</svg>"); // false
- * ```
- */
-export function isBase64DataUri(value: unknown): value is string {
-  return isDataUri(value) && value.includes("base64,");
-}
-
-/**
- * Extract MIME type from data URI
- *
- * @param dataUri - Data URI string
- * @returns MIME type or null if not found
- *
- * @example
- * ```typescript
- * extractMimeType("data:image/png;base64,iVBOR..."); // "image/png"
- * extractMimeType("data:text/plain;charset=utf-8,Hello"); // "text/plain"
- * ```
- */
-export function extractMimeType(dataUri: string): string | null {
-  const match = dataUri.match(/^data:([^;,]+)/);
-  return match ? match[1] : null;
-}
-
-/**
- * Extract base64 content from data URI
- *
- * @param dataUri - Data URI string
- * @returns Base64 content or null if not base64-encoded
- *
- * @example
- * ```typescript
- * extractBase64Content("data:image/png;base64,iVBOR..."); // "iVBOR..."
- * extractBase64Content("data:text/plain,Hello"); // null
- * ```
- */
-export function extractBase64Content(dataUri: string): string | null {
-  const parts = dataUri.split("base64,");
-  return parts.length === 2 ? parts[1] : null;
-}

package/src/infrastructure/utils/validators/string-validator.util.ts

@@ -1,64 +0,0 @@
-/**
- * String Validation Utilities
- * Common string validation patterns
- *
- * Eliminates the duplicated pattern:
- * `value.trim().length === 0`
- * which appeared in 3+ files.
- */
-
-/**
- * Check if string is empty or whitespace-only
- *
- * @param value - Value to check
- * @returns True if the value is an empty string or contains only whitespace
- *
- * @example
- * ```typescript
- * isEmptyString(""); // true
- * isEmptyString("   "); // true
- * isEmptyString("Hello"); // false
- * isEmptyString(null); // false
- * ```
- */
-export function isEmptyString(value: unknown): boolean {
-  return typeof value === "string" && value.trim().length === 0;
-}
-
-/**
- * Check if value is a non-empty string
- * Type guard version for better TypeScript inference
- *
- * @param value - Value to check
- * @returns Type guard indicating if the value is a non-empty string
- *
- * @example
- * ```typescript
- * if (isNonEmptyString(input)) {
- *   // TypeScript knows input is a string here
- *   console.log(input.toUpperCase());
- * }
- * ```
- */
-export function isNonEmptyString(value: unknown): value is string {
-  return typeof value === "string" && value.trim().length > 0;
-}
-
-/**
- * Check if value is a string (empty or non-empty)
- * Basic type guard for string validation
- *
- * @param value - Value to check
- * @returns Type guard indicating if the value is a string
- *
- * @example
- * ```typescript
- * if (isString(value)) {
- *   // TypeScript knows value is a string here
- *   console.log(value.length);
- * }
- * ```
- */
-export function isString(value: unknown): value is string {
-  return typeof value === "string";
-}