@umituz/react-native-ai-fal-provider 2.2.3 → 2.3.0

package/package.json

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

package/src/index.ts

@@ -15,6 +15,7 @@ export * from "./exports/presentation";
 // Init Module Factory
 export {
   createAiProviderInitModule,
+  initializeFalProvider,
   type AiProviderInitModuleConfig,
 } from './init/createAiProviderInitModule';
 

package/src/init/createAiProviderInitModule.ts

@@ -3,6 +3,7 @@
  * Creates a ready-to-use InitModule for app initialization
  */
 
+import { providerRegistry } from '@umituz/react-native-ai-generation-content';
 import { falProvider } from '../infrastructure/services';
 
 /**
@@ -36,15 +37,6 @@ export interface AiProviderInitModuleConfig {
 
   /**
    * Optional callback called after provider is initialized
-   * Use this to register the provider with wizard flow:
-   * @example
-   * ```typescript
-   * onInitialized: () => {
-   *   const { providerRegistry } = require('@umituz/react-native-ai-generation-content');
-   *   const { registerWithWizard } = require('@umituz/react-native-ai-fal-provider');
-   *   registerWithWizard(providerRegistry);
-   * }
-   * ```
    */
   onInitialized?: () => void;
 }
@@ -91,11 +83,14 @@ export function createAiProviderInitModule(
         }
 
         // Initialize FAL provider
-        falProvider.initialize({
-          apiKey,
-        });
+        falProvider.initialize({ apiKey });
+
+        // Register with providerRegistry automatically
+        if (!providerRegistry.hasProvider(falProvider.providerId)) {
+          providerRegistry.register(falProvider);
+        }
+        providerRegistry.setActiveProvider(falProvider.providerId);
 
-        // Call optional callback after initialization
         if (onInitialized) {
           onInitialized();
         }
@@ -107,3 +102,41 @@ export function createAiProviderInitModule(
     },
   };
 }
+
+/**
+ * Initializes FAL provider and registers it with providerRegistry in one call.
+ * Use this for simple synchronous registration at app startup.
+ *
+ * @example
+ * ```typescript
+ * // registerProviders.ts - that's all you need!
+ * import { initializeFalProvider } from "@umituz/react-native-ai-fal-provider";
+ * import { getFalApiKey } from "@/core/utils/env";
+ *
+ * export function registerProviders(): void {
+ *   initializeFalProvider({ apiKey: getFalApiKey() });
+ * }
+ * ```
+ */
+export function initializeFalProvider(config: {
+  apiKey: string | undefined;
+}): boolean {
+  try {
+    const { apiKey } = config;
+
+    if (!apiKey) {
+      return false;
+    }
+
+    falProvider.initialize({ apiKey });
+
+    if (!providerRegistry.hasProvider(falProvider.providerId)) {
+      providerRegistry.register(falProvider);
+    }
+    providerRegistry.setActiveProvider(falProvider.providerId);
+
+    return true;
+  } catch {
+    return false;
+  }
+}

package/src/init/registerWithWizard.ts

@@ -3,28 +3,26 @@
  * Use this when your app uses GenericWizardFlow from @umituz/react-native-ai-generation-content
  */
 
+import { providerRegistry } from '@umituz/react-native-ai-generation-content';
 import { falProvider } from '../infrastructure/services';
 
 /**
- * Register FAL provider with the wizard flow provider registry
+ * Register FAL provider with the wizard flow provider registry.
+ * Optionally accepts a custom registry for backward compatibility.
  *
  * @example
  * ```typescript
- * import { providerRegistry } from '@umituz/react-native-ai-generation-content';
  * import { registerWithWizard } from '@umituz/react-native-ai-fal-provider';
  *
- * // After FAL provider is initialized, register it for wizard flow
- * registerWithWizard(providerRegistry);
+ * // No need to import providerRegistry separately anymore
+ * registerWithWizard();
  * ```
  */
-export function registerWithWizard(registry: {
+export function registerWithWizard(registry?: {
   register: (provider: any) => void;
   setActiveProvider: (id: string) => void;
 }): void {
-  registry.register(falProvider);
-  registry.setActiveProvider('fal');
-
-  if (typeof __DEV__ !== 'undefined' && __DEV__) {
-    console.log('[FAL Provider] Registered with wizard flow');
-  }
+  const reg = registry ?? providerRegistry;
+  reg.register(falProvider);
+  reg.setActiveProvider('fal');
 }