@umituz/react-native-ai-fal-provider 2.3.1 → 2.3.2

package/package.json

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

package/src/infrastructure/services/fal-queue-operations.ts

@@ -5,30 +5,41 @@
 import { fal } from "@fal-ai/client";
 import type { JobSubmission, JobStatus } from "../../domain/types";
 import type { FalQueueStatus } from "../../domain/entities/fal.types";
-import { mapFalStatusToJobStatus } from "./fal-status-mapper";
+import { mapFalStatusToJobStatus, FAL_QUEUE_STATUSES } from "./fal-status-mapper";
+
+const VALID_STATUSES = Object.values(FAL_QUEUE_STATUSES) as string[];
 
 /**
- * Validate and cast FAL queue status response
+ * Normalize FAL queue status response from snake_case (SDK) to camelCase (internal)
  */
-function isValidFalQueueStatus(value: unknown): value is FalQueueStatus {
+function normalizeFalQueueStatus(value: unknown): FalQueueStatus | null {
   if (!value || typeof value !== "object") {
-    return false;
+    return null;
   }
 
-  const status = value as Partial<FalQueueStatus>;
-  const validStatuses = ["IN_QUEUE", "IN_PROGRESS", "COMPLETED", "FAILED"];
+  const raw = value as Record<string, unknown>;
+
+  if (typeof raw.status !== "string" || !VALID_STATUSES.includes(raw.status)) {
+    return null;
+  }
 
-  return (
-    typeof status.status === "string" &&
-    validStatuses.includes(status.status) &&
-    typeof status.requestId === "string"
-  );
+  // FAL SDK returns snake_case (request_id, queue_position)
+  const requestId = (raw.request_id ?? raw.requestId) as string | undefined;
+  if (typeof requestId !== "string") {
+    return null;
+  }
+
+  return {
+    status: raw.status as FalQueueStatus["status"],
+    requestId,
+    queuePosition: (raw.queue_position ?? raw.queuePosition) as number | undefined,
+    logs: Array.isArray(raw.logs) ? raw.logs : undefined,
+  };
 }
 
 export async function submitJob(model: string, input: Record<string, unknown>): Promise<JobSubmission> {
   const result = await fal.queue.submit(model, { input });
 
-  // Validate required fields from FAL API response
   if (!result?.request_id) {
     throw new Error(`FAL API response missing request_id for model ${model}`);
   }
@@ -45,9 +56,10 @@ export async function submitJob(model: string, input: Record<string, unknown>):
 }
 
 export async function getJobStatus(model: string, requestId: string): Promise<JobStatus> {
-  const status = await fal.queue.status(model, { requestId, logs: true });
+  const raw = await fal.queue.status(model, { requestId, logs: true });
 
-  if (!isValidFalQueueStatus(status)) {
+  const status = normalizeFalQueueStatus(raw);
+  if (!status) {
     throw new Error(
       `Invalid FAL queue status response for model ${model}, requestId ${requestId}`
     );
@@ -65,7 +77,6 @@ export async function getJobResult<T = unknown>(model: string, requestId: string
     );
   }
 
-  // Type guard: ensure result.data exists before casting
   if (!('data' in result)) {
     throw new Error(
       `Invalid FAL queue result for model ${model}, requestId ${requestId}: Missing 'data' property`

package/src/infrastructure/services/fal-status-mapper.ts

@@ -6,12 +6,16 @@
 import type { JobStatus, AIJobStatusType } from "../../domain/types";
 import type { FalQueueStatus, FalLogEntry } from "../../domain/entities/fal.types";
 
-const STATUS_MAP = {
-  IN_QUEUE: "IN_QUEUE" as const,
-  IN_PROGRESS: "IN_PROGRESS" as const,
-  COMPLETED: "COMPLETED" as const,
-  FAILED: "FAILED" as const,
-} as const satisfies Record<string, AIJobStatusType>;
+export const FAL_QUEUE_STATUSES = {
+  IN_QUEUE: "IN_QUEUE",
+  IN_PROGRESS: "IN_PROGRESS",
+  COMPLETED: "COMPLETED",
+  FAILED: "FAILED",
+} as const;
+
+export type FalQueueStatusKey = keyof typeof FAL_QUEUE_STATUSES;
+
+const STATUS_MAP = FAL_QUEUE_STATUSES satisfies Record<string, AIJobStatusType>;
 
 const DEFAULT_STATUS: AIJobStatusType = "IN_PROGRESS";