Revert to simple solution using original shared.handleDeepLink instance method

- Keep only the original shared.handleDeepLink() instance method for simplicity
- Handle initial deep links after configure() completes in the completion callback
- iOS: Uses static Superwall.handleDeepLink() native method that safely queues links
- Android: Uses instance method after configuration
- Move _handleInitialLink() call to configure completion to ensure SDK is ready

This is the cleanest approach that leverages the native iOS queuing without
adding complexity or breaking changes to the Flutter API.

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: yusuftor

example/lib/main.dart

@@ -29,8 +29,7 @@ class _MyAppState extends State<MyApp> {
     const useRevenueCat = true;
 
     super.initState();
-    _handleIncomingLinks(); // Set up deep link handling before configuration
-    _handleInitialLink(); // Handle cold start deep links
+    _handleIncomingLinks(); // Set up deep link handling
     configureSuperwall(useRevenueCat);
   }
 
@@ -43,7 +42,7 @@ class _MyAppState extends State<MyApp> {
   void _handleIncomingLinks() {
     appLinks.uriLinkStream.listen((Uri uri) {
       debugPrint('Incoming deep link: $uri');
-      Superwall.handleDeepLink(uri);
+      Superwall.shared.handleDeepLink(uri);
     }, onError: (Object err) {
       print('Error receiving incoming link: $err');
     });
@@ -53,8 +52,8 @@ class _MyAppState extends State<MyApp> {
     appLinks.getInitialLink().then((Uri? initialUri) {
       if (initialUri != null) {
         debugPrint('Initial deep link (cold start): $initialUri');
-        // Safe to call before configure() - static method bypasses shared instance
-        Superwall.handleDeepLinkStatic(initialUri);
+        // Handle after configure completes - iOS SDK will queue it automatically
+        Superwall.shared.handleDeepLink(initialUri);
       }
     }).catchError((Object err) {
       print('Error getting initial link: $err');
@@ -97,6 +96,7 @@ class _MyAppState extends State<MyApp> {
         logging.info('Executing Superwall configure completion block');
         print('Executing Superwall configure completion block');
         listenForPurchases();
+        _handleInitialLink(); // Handle cold start deep links after configure
       });
       Superwall.shared.setDelegate(delegate);
       // MARK: Step 3 – Configure RevenueCat and Sync Subscription Status

lib/src/public/Superwall.dart

@@ -350,18 +350,13 @@ class Superwall {
     await hostApi.preloadPaywallsForPlacements(placementNames.toList());
   }
 
-  // Instance method for backward compatibility
+  // Handles deep links for paywall previews
+  // iOS: Uses static Superwall.handleDeepLink() that safely queues links before configuration
+  // Android: Uses instance method, works after configuration
   Future<bool> handleDeepLink(Uri url) async {
     return await hostApi.handleDeepLink(url.toString());
   }
 
-  // Static method safe to call before configure() - bypasses shared instance
-  // iOS: Uses static Superwall.handleDeepLink() that queues links before configuration
-  // Android: Attempts immediate processing with instance method
-  static Future<bool> handleDeepLinkStatic(Uri url) async {
-    return await hostApi.handleDeepLink(url.toString());
-  }
-
   // Toggles the paywall loading spinner
   Future<void> togglePaywallSpinner(bool isHidden) async {
     await hostApi.togglePaywallSpinner(isHidden);