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

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";
-}