@umituz/react-native-ai-fal-provider 1.0.2 → 1.0.4

package/package.json

@@ -1,24 +1,24 @@
 {
   "name": "@umituz/react-native-ai-fal-provider",
-  "version": "1.0.2",
-  "description": "FAL AI provider service for React Native applications - client wrapper, error handling, and utilities",
+  "version": "1.0.4",
+  "description": "FAL AI provider for React Native - implements IAIProvider interface for unified AI generation",
   "main": "./src/index.ts",
   "types": "./src/index.ts",
   "scripts": {
-    "typecheck": "echo 'TypeScript validation passed'",
-    "lint": "echo 'Lint passed'",
-    "version:patch": "npm version patch -m 'chore: release v%s'",
-    "version:minor": "npm version minor -m 'chore: release v%s'",
-    "version:major": "npm version major -m 'chore: release v%s'"
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts,.tsx --max-warnings 0",
+    "lint:fix": "eslint src --ext .ts,.tsx --fix"
   },
   "keywords": [
     "react-native",
     "fal-ai",
     "ai",
+    "ai-provider",
     "text-to-image",
     "text-to-video",
     "image-to-video",
-    "ai-generation"
+    "ai-generation",
+    "provider-agnostic"
   ],
   "author": "Umit UZ <umit@umituz.com>",
   "license": "MIT",
@@ -28,6 +28,7 @@
   },
   "peerDependencies": {
     "@fal-ai/client": ">=0.6.0",
+    "@umituz/react-native-ai-generation-content": ">=1.16.0",
     "react": ">=18.2.0",
     "react-native": ">=0.74.0"
   },
@@ -36,9 +37,13 @@
   },
   "devDependencies": {
     "@types/react": "~19.1.10",
+    "@typescript-eslint/eslint-plugin": "^7.0.0",
+    "@typescript-eslint/parser": "^7.0.0",
+    "@umituz/react-native-ai-generation-content": "^1.16.0",
+    "eslint": "^8.57.0",
     "react": "19.1.0",
     "react-native": "0.81.5",
-    "typescript": "~5.9.2"
+    "typescript": "^5.3.0"
   },
   "publishConfig": {
     "access": "public"

package/src/index.ts

@@ -1,13 +1,19 @@
 /**
  * @umituz/react-native-ai-fal-provider
- * FAL AI provider service for React Native applications
+ * FAL AI provider for React Native - implements IAIProvider interface
  *
  * Usage:
  *   import {
- *     falClientService,
- *     useFalGeneration,
- *     mapFalError
+ *     FalProvider,
+ *     falProvider,
+ *     providerRegistry,
  *   } from '@umituz/react-native-ai-fal-provider';
+ *   import { providerRegistry } from '@umituz/react-native-ai-generation-content';
+ *
+ *   // Register provider at app startup
+ *   falProvider.initialize({ apiKey: 'your-api-key' });
+ *   providerRegistry.register(falProvider);
+ *   providerRegistry.setActiveProvider('fal');
  */
 
 // =============================================================================
@@ -37,7 +43,13 @@ export type {
 } from "./domain/entities/error.types";
 
 // =============================================================================
-// INFRASTRUCTURE LAYER - Services
+// INFRASTRUCTURE LAYER - Provider (IAIProvider Implementation)
+// =============================================================================
+
+export { FalProvider, falProvider } from "./infrastructure/services";
+
+// =============================================================================
+// INFRASTRUCTURE LAYER - Services (Low-level client)
 // =============================================================================
 
 export { falClientService } from "./infrastructure/services";

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

@@ -0,0 +1,177 @@
+/**
+ * FAL Provider
+ * Implements IAIProvider interface for unified AI generation
+ */
+
+import { fal } from "@fal-ai/client";
+import type {
+  IAIProvider,
+  AIProviderConfig,
+  JobSubmission,
+  JobStatus,
+  AIJobStatusType,
+  SubscribeOptions,
+} from "@umituz/react-native-ai-generation-content";
+import type { FalQueueStatus, FalLogEntry } from "../../domain/entities/fal.types";
+
+declare const __DEV__: boolean;
+
+const DEFAULT_CONFIG = {
+  maxRetries: 3,
+  baseDelay: 1000,
+  maxDelay: 10000,
+  defaultTimeoutMs: 300000,
+};
+
+function mapFalStatusToJobStatus(status: FalQueueStatus): JobStatus {
+  const statusMap: Record<string, AIJobStatusType> = {
+    IN_QUEUE: "IN_QUEUE",
+    IN_PROGRESS: "IN_PROGRESS",
+    COMPLETED: "COMPLETED",
+    FAILED: "FAILED",
+  };
+
+  return {
+    status: statusMap[status.status] ?? "IN_PROGRESS",
+    logs: status.logs?.map((log: FalLogEntry) => ({
+      message: log.message,
+      level: log.level ?? "info",
+      timestamp: log.timestamp,
+    })),
+    queuePosition: status.queuePosition,
+  };
+}
+
+export class FalProvider implements IAIProvider {
+  readonly providerId = "fal";
+  readonly providerName = "FAL AI";
+
+  private apiKey: string | null = null;
+  private config: AIProviderConfig | null = null;
+  private initialized = false;
+
+  initialize(config: AIProviderConfig): void {
+    this.apiKey = config.apiKey;
+    this.config = { ...DEFAULT_CONFIG, ...config };
+
+    fal.config({
+      credentials: config.apiKey,
+      retry: {
+        maxRetries: config.maxRetries ?? DEFAULT_CONFIG.maxRetries,
+        baseDelay: config.baseDelay ?? DEFAULT_CONFIG.baseDelay,
+        maxDelay: config.maxDelay ?? DEFAULT_CONFIG.maxDelay,
+      },
+    });
+
+    this.initialized = true;
+
+    if (typeof __DEV__ !== "undefined" && __DEV__) {
+      // eslint-disable-next-line no-console
+      console.log("[FalProvider] Initialized");
+    }
+  }
+
+  isInitialized(): boolean {
+    return this.initialized;
+  }
+
+  private validateInitialization(): void {
+    if (!this.apiKey || !this.initialized) {
+      throw new Error("FAL provider not initialized. Call initialize() first.");
+    }
+  }
+
+  async submitJob(
+    model: string,
+    input: Record<string, unknown>,
+  ): Promise<JobSubmission> {
+    this.validateInitialization();
+
+    const result = await fal.queue.submit(model, { input });
+
+    return {
+      requestId: result.request_id,
+      statusUrl: result.status_url,
+      responseUrl: result.response_url,
+    };
+  }
+
+  async getJobStatus(model: string, requestId: string): Promise<JobStatus> {
+    this.validateInitialization();
+
+    const status = await fal.queue.status(model, { requestId, logs: true });
+
+    return mapFalStatusToJobStatus(status as unknown as FalQueueStatus);
+  }
+
+  async getJobResult<T = unknown>(model: string, requestId: string): Promise<T> {
+    this.validateInitialization();
+
+    const result = await fal.queue.result(model, { requestId });
+
+    return result.data as T;
+  }
+
+  async subscribe<T = unknown>(
+    model: string,
+    input: Record<string, unknown>,
+    options?: SubscribeOptions<T>,
+  ): Promise<T> {
+    this.validateInitialization();
+
+    const timeoutMs = options?.timeoutMs ?? this.config?.defaultTimeoutMs ?? DEFAULT_CONFIG.defaultTimeoutMs;
+    let timeoutId: ReturnType<typeof setTimeout> | null = null;
+
+    if (typeof __DEV__ !== "undefined" && __DEV__) {
+      // eslint-disable-next-line no-console
+      console.log("[FalProvider] Subscribe started:", { model, timeoutMs });
+    }
+
+    try {
+      const result = await Promise.race([
+        fal.subscribe(model, {
+          input,
+          onQueueUpdate: (update) => {
+            const jobStatus = mapFalStatusToJobStatus(update as unknown as FalQueueStatus);
+            options?.onQueueUpdate?.(jobStatus);
+          },
+        }),
+        new Promise<never>((_, reject) => {
+          timeoutId = setTimeout(
+            () => reject(new Error("FAL subscription timeout")),
+            timeoutMs,
+          );
+        }),
+      ]);
+
+      if (typeof __DEV__ !== "undefined" && __DEV__) {
+        // eslint-disable-next-line no-console
+        console.log("[FalProvider] Subscribe completed:", { model });
+      }
+
+      options?.onResult?.(result as T);
+
+      return result as T;
+    } finally {
+      if (timeoutId) {
+        clearTimeout(timeoutId);
+      }
+    }
+  }
+
+  async run<T = unknown>(model: string, input: Record<string, unknown>): Promise<T> {
+    this.validateInitialization();
+
+    const result = await fal.run(model, { input });
+
+    return result as T;
+  }
+
+  reset(): void {
+    this.apiKey = null;
+    this.config = null;
+    this.initialized = false;
+  }
+}
+
+export const falProvider = new FalProvider();

package/src/infrastructure/services/index.ts

@@ -4,3 +4,4 @@
  */
 
 export { falClientService } from "./fal-client.service";
+export { FalProvider, falProvider } from "./fal-provider";