@umituz/react-native-auth 3.6.20 → 3.6.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@umituz/react-native-auth",
-  "version": "3.6.20",
+  "version": "3.6.22",
   "description": "Authentication service for React Native apps - Secure, type-safe, and production-ready. Provider-agnostic design with dependency injection, configurable validation, and comprehensive error handling.",
   "main": "./src/index.ts",
   "types": "./src/index.ts",

package/src/index.ts

@@ -213,3 +213,9 @@ export type { AuthListenerOptions } from './types/auth-store.types';
 
 // UTILITIES
 export { getAuthErrorLocalizationKey } from './presentation/utils/getAuthErrorMessage';
+
+// Init Module Factory
+export {
+  createAuthInitModule,
+  type AuthInitModuleConfig,
+} from './init';

package/src/init/createAuthInitModule.ts

@@ -0,0 +1,158 @@
+/**
+ * Auth Init Module Factory
+ * Creates a ready-to-use InitModule for app initialization
+ */
+
+import { initializeAuth } from '../infrastructure/services/initializeAuth';
+import type { InitializeAuthOptions } from '../infrastructure/services/initializeAuth';
+import { SubscriptionManager } from '@umituz/react-native-subscription';
+
+declare const __DEV__: boolean;
+
+/**
+ * InitModule interface (from @umituz/react-native-design-system)
+ */
+export interface InitModule {
+  name: string;
+  init: () => Promise<boolean>;
+  critical?: boolean;
+  dependsOn?: string[];
+}
+
+export interface AuthInitModuleConfig {
+  /**
+   * Firestore collection name for user documents
+   * @default "users"
+   */
+  userCollection?: string;
+
+  /**
+   * Whether to auto sign-in as anonymous user
+   * @default true
+   */
+  autoAnonymousSignIn?: boolean;
+
+  /**
+   * Function to collect device extras for user document
+   */
+  collectExtras?: () => Promise<Record<string, unknown>>;
+
+  /**
+   * Storage provider for auth persistence
+   */
+  storageProvider?: InitializeAuthOptions['storageProvider'];
+
+  /**
+   * Whether to restore purchases after user conversion
+   * @default true
+   */
+  restorePurchasesOnConversion?: boolean;
+
+  /**
+   * Custom callback when user converts from anonymous to authenticated
+   */
+  onUserConverted?: (anonymousId: string, authenticatedId: string) => Promise<void>;
+
+  /**
+   * Whether this module is critical for app startup
+   * @default true
+   */
+  critical?: boolean;
+
+  /**
+   * Module dependencies
+   * @default ["firebase"]
+   */
+  dependsOn?: string[];
+}
+
+/**
+ * Creates an Auth initialization module for use with createAppInitializer
+ *
+ * @example
+ * ```typescript
+ * import { createAppInitializer } from "@umituz/react-native-design-system";
+ * import { createFirebaseInitModule } from "@umituz/react-native-firebase";
+ * import { createAuthInitModule } from "@umituz/react-native-auth";
+ * import { storageRepository, collectDeviceExtras } from "@umituz/react-native-design-system";
+ *
+ * export const initializeApp = createAppInitializer({
+ *   modules: [
+ *     createFirebaseInitModule(),
+ *     createAuthInitModule({
+ *       userCollection: "users",
+ *       collectExtras: collectDeviceExtras,
+ *       storageProvider: storageRepository,
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+export function createAuthInitModule(
+  config: AuthInitModuleConfig = {}
+): InitModule {
+  const {
+    userCollection = 'users',
+    autoAnonymousSignIn = true,
+    collectExtras,
+    storageProvider,
+    restorePurchasesOnConversion = true,
+    onUserConverted,
+    critical = true,
+    dependsOn = ['firebase'],
+  } = config;
+
+  return {
+    name: 'auth',
+    critical,
+    dependsOn,
+    init: async () => {
+      try {
+        await initializeAuth({
+          userCollection,
+          autoAnonymousSignIn,
+          collectExtras,
+          storageProvider,
+          onUserConverted: async (anonymousId: string, authenticatedId: string) => {
+            if (typeof __DEV__ !== 'undefined' && __DEV__) {
+              console.log('[createAuthInitModule] User converted:', {
+                anonymousId: anonymousId.slice(0, 8),
+                authenticatedId: authenticatedId.slice(0, 8),
+              });
+            }
+
+            // Restore purchases after conversion
+            if (restorePurchasesOnConversion) {
+              try {
+                const result = await SubscriptionManager.restore();
+                if (typeof __DEV__ !== 'undefined' && __DEV__) {
+                  console.log('[createAuthInitModule] Restore purchases result:', result);
+                }
+              } catch (error) {
+                if (typeof __DEV__ !== 'undefined' && __DEV__) {
+                  console.error('[createAuthInitModule] Restore failed:', error);
+                }
+              }
+            }
+
+            // Call custom callback if provided
+            if (onUserConverted) {
+              await onUserConverted(anonymousId, authenticatedId);
+            }
+          },
+        });
+
+        if (typeof __DEV__ !== 'undefined' && __DEV__) {
+          console.log('[createAuthInitModule] Auth initialized');
+        }
+
+        return true;
+      } catch (error) {
+        if (typeof __DEV__ !== 'undefined' && __DEV__) {
+          console.error('[createAuthInitModule] Error:', error);
+        }
+        return false;
+      }
+    },
+  };
+}

package/src/init/index.ts

@@ -0,0 +1,10 @@
+/**
+ * Auth Init Module
+ * Provides factory for creating app initialization modules
+ */
+
+export {
+  createAuthInitModule,
+  type AuthInitModuleConfig,
+  type InitModule,
+} from './createAuthInitModule';