@bdmakers/react-native-deferred-link 1.0.0

package/DeferredLink.podspec

@@ -0,0 +1,20 @@
+require "json"
+
+package = JSON.parse(File.read(File.join(__dir__, "package.json")))
+
+Pod::Spec.new do |s|
+  s.name         = "DeferredLink"
+  s.version      = package["version"]
+  s.summary      = package["description"]
+  s.homepage     = package["homepage"]
+  s.license      = package["license"]
+  s.authors      = package["author"]
+
+  s.platforms    = { :ios => min_ios_version_supported }
+  s.source       = { :git => "https://github.com/bd-makers/react-native-deferred-link.git", :tag => "#{s.version}" }
+
+  s.source_files = "ios/**/*.{h,m,mm,swift,cpp}"
+  s.private_header_files = "ios/**/*.h"
+
+  install_modules_dependencies(s)
+end

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 aijinet
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,45 @@
+# @bdmakers/react-native-deferred-link
+
+Deferred deep link recovery for React Native
+
+## Installation
+
+```sh
+npm install @bdmakers/react-native-deferred-link
+```
+
+## Usage
+
+```js
+import { DeferredLink } from '@bdmakers/react-native-deferred-link';
+
+// Configure (call once at app startup)
+DeferredLink.configure({
+  domains: ['your-domain.com'],
+  appScheme: 'yourapp',
+});
+
+// Get deferred link on first launch
+const result = await DeferredLink.getInitialDeferredLink();
+if (result.found) {
+  console.log('Deferred link URL:', result.url);
+  console.log('Source:', result.source); // 'android_install_referrer' | 'ios_pasteboard'
+}
+
+// Clear consumed link
+await DeferredLink.clearConsumedDeferredLink();
+```
+
+## Contributing
+
+- [Development workflow](CONTRIBUTING.md#development-workflow)
+- [Sending a pull request](CONTRIBUTING.md#sending-a-pull-request)
+- [Code of conduct](CODE_OF_CONDUCT.md)
+
+## License
+
+MIT
+
+---
+
+Made with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)

package/android/build.gradle

@@ -0,0 +1,71 @@
+buildscript {
+  ext.DeferredLink = [
+    kotlinVersion: "2.0.21",
+    minSdkVersion: 24,
+    compileSdkVersion: 36,
+    targetSdkVersion: 36
+  ]
+
+  ext.getExtOrDefault = { prop ->
+    if (rootProject.ext.has(prop)) {
+      return rootProject.ext.get(prop)
+    }
+
+    return DeferredLink[prop]
+  }
+
+  repositories {
+    google()
+    mavenCentral()
+  }
+
+  dependencies {
+    classpath "com.android.tools.build:gradle:8.7.2"
+    // noinspection DifferentKotlinGradleVersion
+    classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:${getExtOrDefault('kotlinVersion')}"
+  }
+}
+
+
+def isNewArchEnabled = rootProject.hasProperty("newArchEnabled") && rootProject.getProperty("newArchEnabled") == "true"
+
+apply plugin: "com.android.library"
+apply plugin: "kotlin-android"
+
+apply plugin: "com.facebook.react"
+
+android {
+  namespace "com.deferredlink"
+
+  compileSdkVersion getExtOrDefault("compileSdkVersion")
+
+  defaultConfig {
+    minSdkVersion getExtOrDefault("minSdkVersion")
+    targetSdkVersion getExtOrDefault("targetSdkVersion")
+    buildConfigField "boolean", "IS_NEW_ARCHITECTURE_ENABLED", isNewArchEnabled.toString()
+  }
+
+  buildFeatures {
+    buildConfig true
+  }
+
+  buildTypes {
+    release {
+      minifyEnabled false
+    }
+  }
+
+  lint {
+    disable "GradleCompatible"
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_1_8
+    targetCompatibility JavaVersion.VERSION_1_8
+  }
+}
+
+dependencies {
+  implementation "com.facebook.react:react-android"
+  implementation "com.android.installreferrer:installreferrer:2.2"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1,2 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+</manifest>

package/android/src/main/java/com/deferredlink/DeferredLinkModule.kt

@@ -0,0 +1,134 @@
+package com.deferredlink
+
+import android.net.Uri
+import android.util.Log
+import com.facebook.react.bridge.Arguments
+import com.facebook.react.bridge.Promise
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.bridge.ReadableMap
+import com.facebook.react.bridge.WritableMap
+
+class DeferredLinkModule(reactContext: ReactApplicationContext) :
+  NativeDeferredLinkSpec(reactContext) {
+
+  private val storage = DeferredLinkStorage(reactContext)
+  private val referrerParser = ReferrerParser(reactContext)
+
+  private var configDomains: List<String> = emptyList()
+  private var configAppScheme: String? = null
+  private var configReferrerParamKey: String = DEFAULT_REFERRER_PARAM_KEY
+
+  override fun configure(config: ReadableMap) {
+    if (config.hasKey("domains")) {
+      val domainsArray = config.getArray("domains")
+      val domains = mutableListOf<String>()
+      if (domainsArray != null) {
+        for (i in 0 until domainsArray.size()) {
+          domainsArray.getString(i)?.let { domains.add(it) }
+        }
+      }
+      configDomains = domains
+    }
+
+    if (config.hasKey("appScheme")) {
+      configAppScheme = config.getString("appScheme")
+    }
+
+    if (config.hasKey("android")) {
+      val androidConfig = config.getMap("android")
+      if (androidConfig?.hasKey("installReferrerParamKey") == true) {
+        configReferrerParamKey =
+          androidConfig.getString("installReferrerParamKey") ?: DEFAULT_REFERRER_PARAM_KEY
+      }
+    }
+  }
+
+  override fun getInitialDeferredLink(promise: Promise) {
+    if (storage.consumed) {
+      promise.resolve(buildNotFoundResult())
+      return
+    }
+
+    referrerParser.fetchDeferredLink(configReferrerParamKey) { referrerResult ->
+      if (referrerResult == null) {
+        promise.resolve(buildNotFoundResult())
+        return@fetchDeferredLink
+      }
+
+      val url = referrerResult.url
+
+      if (!isDomainAllowed(url)) {
+        Log.d(TAG, "Domain not in allowed list: $url")
+        promise.resolve(buildNotFoundResult())
+        return@fetchDeferredLink
+      }
+
+      storage.markConsumed(url)
+
+      val result = Arguments.createMap().apply {
+        putBoolean("found", true)
+        putString("source", "android_install_referrer")
+        putString("url", url)
+        putString("rawValue", referrerResult.rawReferrer)
+        if (referrerResult.clickedAtSeconds > 0) {
+          putDouble("clickedAt", referrerResult.clickedAtSeconds.toDouble())
+        }
+        val metadata = parseUrlMetadata(url)
+        if (metadata != null) {
+          putMap("metadata", metadata)
+        }
+      }
+      promise.resolve(result)
+    }
+  }
+
+  override fun clearConsumedDeferredLink(promise: Promise) {
+    storage.clear()
+    promise.resolve(null)
+  }
+
+  private fun isDomainAllowed(url: String): Boolean {
+    if (configDomains.isEmpty()) return true
+    return try {
+      val host = Uri.parse(url).host ?: return false
+      configDomains.any { domain ->
+        host == domain || host.endsWith(".$domain")
+      }
+    } catch (e: Exception) {
+      Log.w(TAG, "Failed to parse URL for domain check", e)
+      false
+    }
+  }
+
+  private fun parseUrlMetadata(url: String): WritableMap? {
+    return try {
+      val uri = Uri.parse(url)
+      val paramNames = uri.queryParameterNames
+      if (paramNames.isEmpty()) return null
+      Arguments.createMap().apply {
+        for (key in paramNames) {
+          val value = uri.getQueryParameter(key)
+          if (value != null) {
+            putString(key, value)
+          }
+        }
+      }
+    } catch (e: Exception) {
+      Log.w(TAG, "Failed to parse URL metadata", e)
+      null
+    }
+  }
+
+  private fun buildNotFoundResult(): ReadableMap {
+    return Arguments.createMap().apply {
+      putBoolean("found", false)
+      putString("source", "none")
+    }
+  }
+
+  companion object {
+    const val NAME = NativeDeferredLinkSpec.NAME
+    private const val TAG = "DeferredLinkModule"
+    private const val DEFAULT_REFERRER_PARAM_KEY = "ddl"
+  }
+}

package/android/src/main/java/com/deferredlink/DeferredLinkPackage.kt

@@ -0,0 +1,31 @@
+package com.deferredlink
+
+import com.facebook.react.BaseReactPackage
+import com.facebook.react.bridge.NativeModule
+import com.facebook.react.bridge.ReactApplicationContext
+import com.facebook.react.module.model.ReactModuleInfo
+import com.facebook.react.module.model.ReactModuleInfoProvider
+import java.util.HashMap
+
+class DeferredLinkPackage : BaseReactPackage() {
+  override fun getModule(name: String, reactContext: ReactApplicationContext): NativeModule? {
+    return if (name == DeferredLinkModule.NAME) {
+      DeferredLinkModule(reactContext)
+    } else {
+      null
+    }
+  }
+
+  override fun getReactModuleInfoProvider() = ReactModuleInfoProvider {
+    mapOf(
+      DeferredLinkModule.NAME to ReactModuleInfo(
+        name = DeferredLinkModule.NAME,
+        className = DeferredLinkModule.NAME,
+        canOverrideExistingModule = false,
+        needsEagerInit = false,
+        isCxxModule = false,
+        isTurboModule = BuildConfig.IS_NEW_ARCHITECTURE_ENABLED
+      )
+    )
+  }
+}

package/android/src/main/java/com/deferredlink/DeferredLinkStorage.kt

@@ -0,0 +1,45 @@
+package com.deferredlink
+
+import android.content.Context
+import android.content.SharedPreferences
+
+class DeferredLinkStorage(context: Context) {
+
+  private val prefs: SharedPreferences =
+    context.getSharedPreferences(PREFS_NAME, Context.MODE_PRIVATE)
+
+  var consumed: Boolean
+    get() = prefs.getBoolean(KEY_CONSUMED, false)
+    set(value) = prefs.edit().putBoolean(KEY_CONSUMED, value).apply()
+
+  var lastValue: String?
+    get() = prefs.getString(KEY_LAST_VALUE, null)
+    set(value) = prefs.edit().putString(KEY_LAST_VALUE, value).apply()
+
+  var lastConsumedAt: Long
+    get() = prefs.getLong(KEY_LAST_CONSUMED_AT, 0L)
+    set(value) = prefs.edit().putLong(KEY_LAST_CONSUMED_AT, value).apply()
+
+  fun markConsumed(url: String) {
+    prefs.edit()
+      .putBoolean(KEY_CONSUMED, true)
+      .putString(KEY_LAST_VALUE, url)
+      .putLong(KEY_LAST_CONSUMED_AT, System.currentTimeMillis())
+      .apply()
+  }
+
+  fun clear() {
+    prefs.edit()
+      .remove(KEY_CONSUMED)
+      .remove(KEY_LAST_VALUE)
+      .remove(KEY_LAST_CONSUMED_AT)
+      .apply()
+  }
+
+  companion object {
+    private const val PREFS_NAME = "deferred_link_storage"
+    private const val KEY_CONSUMED = "deferred_link.consumed"
+    private const val KEY_LAST_VALUE = "deferred_link.last_value"
+    private const val KEY_LAST_CONSUMED_AT = "deferred_link.last_consumed_at"
+  }
+}

package/android/src/main/java/com/deferredlink/ReferrerParser.kt

@@ -0,0 +1,77 @@
+package com.deferredlink
+
+import android.content.Context
+import android.net.Uri
+import android.util.Log
+import com.android.installreferrer.api.InstallReferrerClient
+import com.android.installreferrer.api.InstallReferrerStateListener
+
+data class ReferrerResult(
+  val url: String,
+  val clickedAtSeconds: Long,
+  val rawReferrer: String
+)
+
+class ReferrerParser(private val context: Context) {
+
+  fun fetchDeferredLink(paramKey: String, onResult: (ReferrerResult?) -> Unit) {
+    val client = InstallReferrerClient.newBuilder(context).build()
+
+    client.startConnection(object : InstallReferrerStateListener {
+      override fun onInstallReferrerSetupFinished(responseCode: Int) {
+        when (responseCode) {
+          InstallReferrerClient.InstallReferrerResponse.OK -> {
+            try {
+              val details = client.installReferrer
+              val referrerString = details.installReferrer
+              val clickedAt = details.referrerClickTimestampSeconds
+              val url = extractDeferredLink(referrerString, paramKey)
+              if (url != null) {
+                onResult(ReferrerResult(url, clickedAt, referrerString))
+              } else {
+                onResult(null)
+              }
+            } catch (e: Exception) {
+              Log.w(TAG, "Failed to read install referrer", e)
+              onResult(null)
+            } finally {
+              client.endConnection()
+            }
+          }
+          InstallReferrerClient.InstallReferrerResponse.FEATURE_NOT_SUPPORTED,
+          InstallReferrerClient.InstallReferrerResponse.SERVICE_UNAVAILABLE -> {
+            Log.d(TAG, "Install referrer not available: responseCode=$responseCode")
+            onResult(null)
+            client.endConnection()
+          }
+          else -> {
+            Log.d(TAG, "Install referrer unknown response: $responseCode")
+            onResult(null)
+            client.endConnection()
+          }
+        }
+      }
+
+      override fun onInstallReferrerServiceDisconnected() {
+        Log.d(TAG, "Install referrer service disconnected")
+      }
+    })
+  }
+
+  private fun extractDeferredLink(referrerString: String, paramKey: String): String? {
+    if (referrerString.isBlank()) return null
+    return try {
+      // Referrer string format: URL-encoded query params (e.g. "utm_source=google&ddl=https%3A%2F%2F...")
+      val fakeUri = Uri.parse("https://dummy?$referrerString")
+      val encodedValue = fakeUri.getQueryParameter(paramKey)
+      if (encodedValue.isNullOrBlank()) null else encodedValue
+    } catch (e: Exception) {
+      Log.w(TAG, "Failed to parse referrer string", e)
+      null
+    }
+  }
+
+  companion object {
+    private const val TAG = "ReferrerParser"
+  }
+}

package/ios/DeferredLink.h

@@ -0,0 +1,4 @@
+#import <DeferredLinkSpec/DeferredLinkSpec.h>
+
+@interface DeferredLink : NSObject <NativeDeferredLinkSpec>
+@end

package/ios/DeferredLink.mm

@@ -0,0 +1,288 @@
+#import "DeferredLink.h"
+#import <UIKit/UIKit.h>
+
+static NSString *const kStorageSuiteKey = @"com.deferredlink.storage";
+static NSString *const kConsumedKey = @"deferred_link.consumed";
+static NSString *const kLastValueKey = @"deferred_link.last_value";
+static NSString *const kLastConsumedAtKey = @"deferred_link.last_consumed_at";
+static NSString *const kPayloadSeparator = @"|";
+
+@implementation DeferredLink {
+  NSArray<NSString *> *_configDomains;
+  NSString *_configAppScheme;
+  NSString *_configPasteboardPrefix;
+  NSTimeInterval _configPasteboardTTLSeconds;
+}
+
+- (instancetype)init {
+  self = [super init];
+  if (self) {
+    _configDomains = @[];
+    _configAppScheme = nil;
+    _configPasteboardPrefix = @"bodoc:ddl:";
+    _configPasteboardTTLSeconds = 900;
+    NSLog(@"[DeferredLink] module initialized (defaults: prefix=%@, ttl=%.0f)",
+          _configPasteboardPrefix, _configPasteboardTTLSeconds);
+  }
+  return self;
+}
+
+RCT_EXPORT_MODULE(DeferredLink)
+
++ (BOOL)requiresMainQueueSetup {
+  return NO;
+}
+
+#pragma mark - Public API
+
+// configure — RCT_EXPORT_METHOD provides both bridge discovery and TurboModule compatibility
+RCT_EXPORT_METHOD(configure:(NSDictionary *)config)
+{
+  NSLog(@"[DeferredLink] configure called with: %@", config);
+
+  if (config[@"domains"]) {
+    _configDomains = config[@"domains"];
+  }
+  if (config[@"appScheme"]) {
+    _configAppScheme = config[@"appScheme"];
+  }
+  NSDictionary *iosConfig = config[@"ios"];
+  if (iosConfig) {
+    if (iosConfig[@"pasteboardPrefix"]) {
+      _configPasteboardPrefix = iosConfig[@"pasteboardPrefix"];
+    }
+    if (iosConfig[@"pasteboardTTLSeconds"]) {
+      _configPasteboardTTLSeconds = [iosConfig[@"pasteboardTTLSeconds"] doubleValue];
+    }
+  }
+
+  NSLog(@"[DeferredLink] configured — domains=%@, scheme=%@, prefix=%@, ttl=%.0f",
+        _configDomains, _configAppScheme, _configPasteboardPrefix, _configPasteboardTTLSeconds);
+}
+
+// getInitialDeferredLink — RCT_EXPORT_METHOD provides both bridge discovery and TurboModule compatibility
+RCT_EXPORT_METHOD(getInitialDeferredLink:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+{
+  NSLog(@"[DeferredLink] getInitialDeferredLink called (thread: %@)", [NSThread currentThread]);
+
+  NSUserDefaults *defaults = [[NSUserDefaults alloc] initWithSuiteName:kStorageSuiteKey];
+  BOOL consumed = [defaults boolForKey:kConsumedKey];
+
+  NSLog(@"[DeferredLink] consumed flag = %@, suite = %@", consumed ? @"YES" : @"NO", kStorageSuiteKey);
+
+  if (consumed) {
+    NSString *lastValue = [defaults objectForKey:kLastValueKey];
+    NSLog(@"[DeferredLink] already consumed (lastValue: %@), returning not-found", lastValue);
+    resolve([self buildNotFoundResult]);
+    return;
+  }
+
+  // UIPasteboard MUST be accessed on the main thread (iOS 16+ silently
+  // returns nil and skips the paste banner when accessed off-main).
+  dispatch_async(dispatch_get_main_queue(), ^{
+    NSLog(@"[DeferredLink] reading pasteboard on main thread");
+
+    NSDictionary *payload = [self parsePasteboardPayload];
+
+    if (!payload) {
+      NSLog(@"[DeferredLink] pasteboard payload is nil — returning not-found");
+      resolve([self buildNotFoundResult]);
+      return;
+    }
+
+    NSString *url = payload[@"url"];
+    NSNumber *clickedAt = payload[@"clickedAt"];
+
+    NSLog(@"[DeferredLink] payload url=%@, clickedAt=%@, rawValue=%@",
+          url, clickedAt, payload[@"rawValue"]);
+
+    // TTL enforcement: reject expired payloads
+    if (clickedAt && self->_configPasteboardTTLSeconds > 0) {
+      NSTimeInterval now = [[NSDate date] timeIntervalSince1970];
+      NSTimeInterval elapsed = now - [clickedAt doubleValue];
+      NSLog(@"[DeferredLink] TTL check: elapsed=%.0fs, limit=%.0fs",
+            elapsed, self->_configPasteboardTTLSeconds);
+      if (elapsed > self->_configPasteboardTTLSeconds) {
+        NSLog(@"[DeferredLink] payload expired — returning not-found");
+        resolve([self buildNotFoundResult]);
+        return;
+      }
+    }
+
+    // Domain validation
+    if (![self isDomainAllowed:url]) {
+      NSLog(@"[DeferredLink] domain not allowed for url: %@", url);
+      resolve([self buildNotFoundResult]);
+      return;
+    }
+
+    [self markConsumed:url];
+
+    NSMutableDictionary *result = [NSMutableDictionary dictionaryWithDictionary:@{
+      @"found": @YES,
+      @"source": @"ios_pasteboard",
+      @"url": url,
+      @"rawValue": payload[@"rawValue"] ?: url,
+    }];
+
+    if (clickedAt) {
+      result[@"clickedAt"] = clickedAt;
+    }
+
+    NSDictionary *metadata = [self parseUrlMetadata:url];
+    if (metadata && metadata.count > 0) {
+      result[@"metadata"] = metadata;
+    }
+
+    NSLog(@"[DeferredLink] SUCCESS — found deferred link: %@", url);
+    resolve([result copy]);
+  });
+}
+
+// clearConsumedDeferredLink — RCT_EXPORT_METHOD provides both bridge discovery and TurboModule compatibility
+RCT_EXPORT_METHOD(clearConsumedDeferredLink:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+{
+  NSLog(@"[DeferredLink] clearConsumedDeferredLink called");
+  NSUserDefaults *defaults = [[NSUserDefaults alloc] initWithSuiteName:kStorageSuiteKey];
+  [defaults removeObjectForKey:kConsumedKey];
+  [defaults removeObjectForKey:kLastValueKey];
+  [defaults removeObjectForKey:kLastConsumedAtKey];
+  resolve(nil);
+}
+
+#pragma mark - Pasteboard
+
+/// Reads and parses pasteboard content.
+/// Payload format: `<prefix><epoch_seconds>|<url>` (with timestamp)
+///            or:  `<prefix><url>` (legacy, no TTL enforcement)
+/// Returns dictionary with keys: url, rawValue, clickedAt (optional), or nil if invalid.
+- (NSDictionary *)parsePasteboardPayload {
+  UIPasteboard *pasteboard = [UIPasteboard generalPasteboard];
+  NSString *text = pasteboard.string;
+
+  NSLog(@"[DeferredLink] parsePasteboardPayload — isMainThread=%@, raw text=%@",
+        [NSThread isMainThread] ? @"YES" : @"NO",
+        text ? [NSString stringWithFormat:@"\"%@\" (len=%lu)", text, (unsigned long)text.length] : @"nil");
+
+  if (!text || text.length == 0) {
+    NSLog(@"[DeferredLink] pasteboard is empty");
+    return nil;
+  }
+
+  // Prefix filtering
+  if (_configPasteboardPrefix && _configPasteboardPrefix.length > 0) {
+    if (![text hasPrefix:_configPasteboardPrefix]) {
+      return nil;
+    }
+    NSString *rawValue = text;
+    text = [text substringFromIndex:_configPasteboardPrefix.length];
+
+    if (text.length == 0) {
+      return nil;
+    }
+
+    // Try to parse timestamp|url format
+    NSRange separatorRange = [text rangeOfString:kPayloadSeparator];
+    if (separatorRange.location != NSNotFound) {
+      NSString *timestampStr = [text substringToIndex:separatorRange.location];
+      NSString *url = [text substringFromIndex:NSMaxRange(separatorRange)];
+
+      // Validate timestamp is numeric
+      NSTimeInterval timestamp = [timestampStr doubleValue];
+      if (timestamp > 0 && url.length > 0) {
+        return @{
+          @"url": url,
+          @"rawValue": rawValue,
+          @"clickedAt": @(timestamp),
+        };
+      }
+    }
+
+    // Legacy format: entire remaining text is the URL
+    return @{
+      @"url": text,
+      @"rawValue": rawValue,
+    };
+  }
+
+  // No prefix configured: treat entire text as URL
+  return @{
+    @"url": text,
+    @"rawValue": text,
+  };
+}
+
+#pragma mark - Validation
+
+- (BOOL)isDomainAllowed:(NSString *)urlString {
+  if (_configDomains.count == 0) {
+    return YES;
+  }
+
+  NSURL *url = [NSURL URLWithString:urlString];
+  NSString *host = url.host;
+  if (!host) {
+    return NO;
+  }
+
+  for (NSString *domain in _configDomains) {
+    if ([host isEqualToString:domain] ||
+        [host hasSuffix:[@"." stringByAppendingString:domain]]) {
+      return YES;
+    }
+  }
+
+  return NO;
+}
+
+#pragma mark - URL Metadata
+
+- (NSDictionary *)parseUrlMetadata:(NSString *)urlString {
+  NSURL *url = [NSURL URLWithString:urlString];
+  if (!url) {
+    return nil;
+  }
+
+  NSURLComponents *components = [NSURLComponents componentsWithURL:url resolvingAgainstBaseURL:NO];
+  NSArray<NSURLQueryItem *> *queryItems = components.queryItems;
+  if (!queryItems || queryItems.count == 0) {
+    return nil;
+  }
+
+  NSMutableDictionary *metadata = [NSMutableDictionary dictionary];
+  for (NSURLQueryItem *item in queryItems) {
+    if (item.value) {
+      metadata[item.name] = item.value;
+    }
+  }
+
+  return metadata.count > 0 ? [metadata copy] : nil;
+}
+
+#pragma mark - Storage
+
+- (void)markConsumed:(NSString *)url {
+  NSUserDefaults *defaults = [[NSUserDefaults alloc] initWithSuiteName:kStorageSuiteKey];
+  [defaults setBool:YES forKey:kConsumedKey];
+  [defaults setObject:url forKey:kLastValueKey];
+  [defaults setDouble:[[NSDate date] timeIntervalSince1970] forKey:kLastConsumedAtKey];
+}
+
+- (NSDictionary *)buildNotFoundResult {
+  return @{
+    @"found": @NO,
+    @"source": @"none",
+  };
+}
+
+#pragma mark - TurboModule
+
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params
+{
+    return std::make_shared<facebook::react::NativeDeferredLinkSpecJSI>(params);
+}
+
+@end

package/lib/module/NativeDeferredLink.js

@@ -0,0 +1,5 @@
+"use strict";
+
+import { TurboModuleRegistry } from 'react-native';
+export default TurboModuleRegistry.get('DeferredLink');
+//# sourceMappingURL=NativeDeferredLink.js.map

package/lib/module/NativeDeferredLink.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["TurboModuleRegistry","get"],"sourceRoot":"../../src","sources":["NativeDeferredLink.ts"],"mappings":";;AACA,SAASA,mBAAmB,QAAQ,cAAc;AAQlD,eAAeA,mBAAmB,CAACC,GAAG,CAAO,cAAc,CAAC","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,45 @@
+"use strict";
+
+import { NativeModules } from 'react-native';
+import NativeDeferredLink from "./NativeDeferredLink.js";
+const TAG = '[react-native-deferred-link]';
+const LINKING_WARNING = `${TAG} Native module not found. ` + 'Make sure you have run `pod install` and rebuilt the app. ' + 'Deferred link features will be unavailable.';
+const nativeModule = NativeDeferredLink ?? NativeModules.DeferredLink ?? null;
+if (!nativeModule) {
+  console.warn(LINKING_WARNING);
+} else {
+  console.log(`${TAG} Native module loaded (turbo=${!!NativeDeferredLink}, bridge=${!!NativeModules.DeferredLink})`);
+}
+const NOT_FOUND_RESULT = {
+  found: false,
+  source: 'none'
+};
+export const DeferredLink = {
+  configure(config) {
+    if (!nativeModule) {
+      console.warn(`${TAG} configure skipped — native module is null`);
+      return;
+    }
+    console.log(`${TAG} configure`, JSON.stringify(config));
+    nativeModule.configure(config);
+  },
+  async getInitialDeferredLink() {
+    if (!nativeModule) {
+      console.warn(`${TAG} getInitialDeferredLink skipped — native module is null`);
+      return NOT_FOUND_RESULT;
+    }
+    console.log(`${TAG} getInitialDeferredLink called`);
+    const raw = await nativeModule.getInitialDeferredLink();
+    const result = raw;
+    console.log(`${TAG} getInitialDeferredLink result:`, JSON.stringify(result));
+    return result;
+  },
+  async clearConsumedDeferredLink() {
+    if (!nativeModule) {
+      return;
+    }
+    console.log(`${TAG} clearConsumedDeferredLink called`);
+    await nativeModule.clearConsumedDeferredLink();
+  }
+};
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NativeModules","NativeDeferredLink","TAG","LINKING_WARNING","nativeModule","DeferredLink","console","warn","log","NOT_FOUND_RESULT","found","source","configure","config","JSON","stringify","getInitialDeferredLink","raw","result","clearConsumedDeferredLink"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAASA,aAAa,QAAQ,cAAc;AAG5C,OAAOC,kBAAkB,MAAM,yBAAsB;AAcrD,MAAMC,GAAG,GAAG,8BAA8B;AAE1C,MAAMC,eAAe,GACnB,GAAGD,GAAG,4BAA4B,GAClC,4DAA4D,GAC5D,6CAA6C;AAE/C,MAAME,YAAyB,GAC7BH,kBAAkB,IACjBD,aAAa,CAACK,YAAiC,IAChD,IAAI;AAEN,IAAI,CAACD,YAAY,EAAE;EACjBE,OAAO,CAACC,IAAI,CAACJ,eAAe,CAAC;AAC/B,CAAC,MAAM;EACLG,OAAO,CAACE,GAAG,CACT,GAAGN,GAAG,gCAAgC,CAAC,CAACD,kBAAkB,YAAY,CAAC,CAACD,aAAa,CAACK,YAAY,GACpG,CAAC;AACH;AAEA,MAAMI,gBAAoC,GAAG;EAC3CC,KAAK,EAAE,KAAK;EACZC,MAAM,EAAE;AACV,CAAC;AAED,OAAO,MAAMN,YAAiC,GAAG;EAC/CO,SAASA,CAACC,MAA0B,EAAQ;IAC1C,IAAI,CAACT,YAAY,EAAE;MACjBE,OAAO,CAACC,IAAI,CAAC,GAAGL,GAAG,4CAA4C,CAAC;MAChE;IACF;IACAI,OAAO,CAACE,GAAG,CAAC,GAAGN,GAAG,YAAY,EAAEY,IAAI,CAACC,SAAS,CAACF,MAAM,CAAC,CAAC;IACvDT,YAAY,CAACQ,SAAS,CAACC,MAA2B,CAAC;EACrD,CAAC;EAED,MAAMG,sBAAsBA,CAAA,EAAgC;IAC1D,IAAI,CAACZ,YAAY,EAAE;MACjBE,OAAO,CAACC,IAAI,CACV,GAAGL,GAAG,yDACR,CAAC;MACD,OAAOO,gBAAgB;IACzB;IACAH,OAAO,CAACE,GAAG,CAAC,GAAGN,GAAG,gCAAgC,CAAC;IACnD,MAAMe,GAAG,GAAG,MAAMb,YAAY,CAACY,sBAAsB,CAAC,CAAC;IACvD,MAAME,MAAM,GAAGD,GAAoC;IACnDX,OAAO,CAACE,GAAG,CACT,GAAGN,GAAG,iCAAiC,EACvCY,IAAI,CAACC,SAAS,CAACG,MAAM,CACvB,CAAC;IACD,OAAOA,MAAM;EACf,CAAC;EAED,MAAMC,yBAAyBA,CAAA,EAAkB;IAC/C,IAAI,CAACf,YAAY,EAAE;MACjB;IACF;IACAE,OAAO,CAACE,GAAG,CAAC,GAAGN,GAAG,mCAAmC,CAAC;IACtD,MAAME,YAAY,CAACe,yBAAyB,CAAC,CAAC;EAChD;AACF,CAAC","ignoreList":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/module/types.js

@@ -0,0 +1,2 @@
+"use strict";
+//# sourceMappingURL=types.js.map

package/lib/module/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../src","sources":["types.ts"],"mappings":"","ignoreList":[]}

package/lib/typescript/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/typescript/src/NativeDeferredLink.d.ts

@@ -0,0 +1,9 @@
+import type { TurboModule } from 'react-native';
+export interface Spec extends TurboModule {
+    configure(config: Object): void;
+    getInitialDeferredLink(): Promise<Object>;
+    clearConsumedDeferredLink(): Promise<void>;
+}
+declare const _default: Spec | null;
+export default _default;
+//# sourceMappingURL=NativeDeferredLink.d.ts.map

package/lib/typescript/src/NativeDeferredLink.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeDeferredLink.d.ts","sourceRoot":"","sources":["../../../src/NativeDeferredLink.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,sBAAsB,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1C,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C;;AAED,wBAA6D"}

package/lib/typescript/src/index.d.ts

@@ -0,0 +1,4 @@
+import type { IDeferredLinkModule } from './types';
+export type { DeferredLinkConfig, DeferredLinkResult, DeferredLinkSource, IDeferredLinkModule, } from './types';
+export declare const DeferredLink: IDeferredLinkModule;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAGV,mBAAmB,EACpB,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,GACpB,MAAM,SAAS,CAAC;AA2BjB,eAAO,MAAM,YAAY,EAAE,mBAkC1B,CAAC"}

package/lib/typescript/src/types.d.ts

@@ -0,0 +1,27 @@
+export type DeferredLinkSource = 'android_install_referrer' | 'ios_pasteboard' | 'none';
+export type DeferredLinkResult = {
+    found: boolean;
+    source: DeferredLinkSource;
+    url?: string;
+    rawValue?: string;
+    clickedAt?: number;
+    isFirstLaunch?: boolean;
+    metadata?: Record<string, string>;
+};
+export type DeferredLinkConfig = {
+    domains: string[];
+    appScheme?: string;
+    ios?: {
+        pasteboardPrefix?: string;
+        pasteboardTTLSeconds?: number;
+    };
+    android?: {
+        installReferrerParamKey?: string;
+    };
+};
+export interface IDeferredLinkModule {
+    configure(config: DeferredLinkConfig): void;
+    getInitialDeferredLink(): Promise<DeferredLinkResult>;
+    clearConsumedDeferredLink(): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAC1B,0BAA0B,GAC1B,gBAAgB,GAChB,MAAM,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,kBAAkB,CAAC;IAC3B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE;QACJ,gBAAgB,CAAC,EAAE,MAAM,CAAC;QAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;KAC/B,CAAC;IACF,OAAO,CAAC,EAAE;QACR,uBAAuB,CAAC,EAAE,MAAM,CAAC;KAClC,CAAC;CACH,CAAC;AAEF,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC;IAC5C,sBAAsB,IAAI,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACtD,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5C"}

package/package.json

@@ -0,0 +1,123 @@
+{
+  "name": "@bdmakers/react-native-deferred-link",
+  "version": "1.0.0",
+  "description": "Deferred deep link recovery for React Native",
+  "main": "./lib/module/index.js",
+  "module": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "react-native": "./src/index.tsx",
+  "source": "./src/index.tsx",
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn --cwd example",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\""
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android",
+    "deep-link",
+    "deferred-link"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bd-makers/react-native-deferred-link.git"
+  },
+  "author": "aijinet <dev@aijinet.com> (https://github.com/aijinet)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/bd-makers/react-native-deferred-link/issues"
+  },
+  "homepage": "https://github.com/bd-makers/react-native-deferred-link#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^1.3.2",
+    "@eslint/eslintrc": "^3.3.1",
+    "@eslint/js": "^9.35.0",
+    "@react-native/babel-preset": "0.79.6",
+    "@react-native/eslint-config": "0.83.0",
+    "@types/react": "^19.0.0",
+    "del-cli": "^6.0.0",
+    "eslint": "^9.35.0",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.4",
+    "prettier": "^2.8.8",
+    "react": "19.0.0",
+    "react-native": "0.79.6",
+    "react-native-builder-bob": "^0.40.13",
+    "typescript": "^5.9.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "codegenConfig": {
+    "name": "DeferredLinkSpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "android": {
+      "javaPackageName": "com.deferredlink"
+    },
+    "ios": {
+      "modulesProvider": {
+        "DeferredLink": "DeferredLink"
+      }
+    }
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "create-react-native-library": {
+    "type": "turbo-module",
+    "languages": "kotlin-objc",
+    "tools": [
+      "eslint"
+    ],
+    "version": "0.57.2"
+  }
+}

package/src/NativeDeferredLink.ts

@@ -0,0 +1,10 @@
+import type { TurboModule } from 'react-native';
+import { TurboModuleRegistry } from 'react-native';
+
+export interface Spec extends TurboModule {
+  configure(config: Object): void;
+  getInitialDeferredLink(): Promise<Object>;
+  clearConsumedDeferredLink(): Promise<void>;
+}
+
+export default TurboModuleRegistry.get<Spec>('DeferredLink');

package/src/index.tsx

@@ -0,0 +1,77 @@
+import { NativeModules } from 'react-native';
+
+import type { Spec } from './NativeDeferredLink';
+import NativeDeferredLink from './NativeDeferredLink';
+import type {
+  DeferredLinkConfig,
+  DeferredLinkResult,
+  IDeferredLinkModule,
+} from './types';
+
+export type {
+  DeferredLinkConfig,
+  DeferredLinkResult,
+  DeferredLinkSource,
+  IDeferredLinkModule,
+} from './types';
+
+const TAG = '[react-native-deferred-link]';
+
+const LINKING_WARNING =
+  `${TAG} Native module not found. ` +
+  'Make sure you have run `pod install` and rebuilt the app. ' +
+  'Deferred link features will be unavailable.';
+
+const nativeModule: Spec | null =
+  NativeDeferredLink ??
+  (NativeModules.DeferredLink as Spec | undefined) ??
+  null;
+
+if (!nativeModule) {
+  console.warn(LINKING_WARNING);
+} else {
+  console.log(
+    `${TAG} Native module loaded (turbo=${!!NativeDeferredLink}, bridge=${!!NativeModules.DeferredLink})`
+  );
+}
+
+const NOT_FOUND_RESULT: DeferredLinkResult = {
+  found: false,
+  source: 'none',
+};
+
+export const DeferredLink: IDeferredLinkModule = {
+  configure(config: DeferredLinkConfig): void {
+    if (!nativeModule) {
+      console.warn(`${TAG} configure skipped — native module is null`);
+      return;
+    }
+    console.log(`${TAG} configure`, JSON.stringify(config));
+    nativeModule.configure(config as unknown as Object);
+  },
+
+  async getInitialDeferredLink(): Promise<DeferredLinkResult> {
+    if (!nativeModule) {
+      console.warn(
+        `${TAG} getInitialDeferredLink skipped — native module is null`
+      );
+      return NOT_FOUND_RESULT;
+    }
+    console.log(`${TAG} getInitialDeferredLink called`);
+    const raw = await nativeModule.getInitialDeferredLink();
+    const result = raw as unknown as DeferredLinkResult;
+    console.log(
+      `${TAG} getInitialDeferredLink result:`,
+      JSON.stringify(result)
+    );
+    return result;
+  },
+
+  async clearConsumedDeferredLink(): Promise<void> {
+    if (!nativeModule) {
+      return;
+    }
+    console.log(`${TAG} clearConsumedDeferredLink called`);
+    await nativeModule.clearConsumedDeferredLink();
+  },
+};

package/src/types.ts

@@ -0,0 +1,32 @@
+export type DeferredLinkSource =
+  | 'android_install_referrer'
+  | 'ios_pasteboard'
+  | 'none';
+
+export type DeferredLinkResult = {
+  found: boolean;
+  source: DeferredLinkSource;
+  url?: string;
+  rawValue?: string;
+  clickedAt?: number;
+  isFirstLaunch?: boolean;
+  metadata?: Record<string, string>;
+};
+
+export type DeferredLinkConfig = {
+  domains: string[];
+  appScheme?: string;
+  ios?: {
+    pasteboardPrefix?: string;
+    pasteboardTTLSeconds?: number;
+  };
+  android?: {
+    installReferrerParamKey?: string;
+  };
+};
+
+export interface IDeferredLinkModule {
+  configure(config: DeferredLinkConfig): void;
+  getInitialDeferredLink(): Promise<DeferredLinkResult>;
+  clearConsumedDeferredLink(): Promise<void>;
+}