Change to 5 sec delay when re-launching app clip (#61)

* Change to 5 sec delay when re-launching app clip

* Add option to use deffered deep links on android from triggerReclaimFlow, and getRequestUrl

* Bump patch version

* Update docs

Author: predatorx7

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@reclaimprotocol/js-sdk",
-  "version": "4.6.0",
+  "version": "4.6.1",
   "description": "Designed to request proofs from the Reclaim protocol and manage the flow of claims and witness interactions.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

src/Reclaim.ts

@@ -9,6 +9,7 @@ import {
     InitSessionResponse,
     ClaimCreationType,
     ModalOptions,
+    ReclaimFlowLaunchOptions,
 } from './utils/types'
 import { SessionStatus, DeviceType } from './utils/types'
 import { ethers } from 'ethers'
@@ -39,7 +40,6 @@ import { assertValidSignedClaim, createLinkWithTemplateData, getWitnessesForClai
 import { QRCodeModal } from './utils/modalUtils'
 import loggerModule from './utils/logger';
 import { getDeviceType, getMobileDeviceType, isMobileDevice } from './utils/device'
-import { Features } from './utils/apis/feature'
 import { canonicalStringify } from './utils/strings'
 const logger = loggerModule.logger
 
@@ -196,7 +196,6 @@ export class ReclaimProofRequest {
     private modalOptions?: ModalOptions;
     private modal?: QRCodeModal;
     private readonly FAILURE_TIMEOUT = 30 * 1000; // 30 seconds timeout, can be adjusted
-    private isNewLinkingEnabledAsync: Promise<boolean>
 
     private constructor(applicationId: string, providerId: string, options?: ProofRequestOptions) {
         this.providerId = providerId;
@@ -243,12 +242,6 @@ export class ReclaimProofRequest {
         // Fetch sdk version from package.json
         this.sdkVersion = 'js-' + sdkVersion;
         logger.info(`Initializing client with applicationId: ${this.applicationId}`);
-
-        this.isNewLinkingEnabledAsync = Features.isNewLinkingEnabled({
-            applicationId: applicationId,
-            providerId: providerId,
-            sessionId: this.sessionId,
-        });
     }
 
     /**
@@ -839,6 +832,7 @@ export class ReclaimProofRequest {
      * - Mobile Android: Returns Instant App URL (if useAppClip is enabled)
      * - Desktop/Other: Returns standard verification URL
      *
+     * @param launchOptions - Optional launch configuration to override default behavior
      * @returns Promise<string> - The generated request URL
      * @throws {SignatureNotFoundError} When signature is not set
      *
@@ -848,7 +842,9 @@ export class ReclaimProofRequest {
      * // Share this URL with users or display as QR code
      * ```
      */
-    async getRequestUrl(): Promise<string> {
+    async getRequestUrl(launchOptions?: ReclaimFlowLaunchOptions): Promise<string> {
+        const options = launchOptions || this.options?.launchOptions || {};
+
         logger.info('Creating Request Url')
         if (!this.signature) {
             throw new SignatureNotFoundError('Signature is not set.')
@@ -867,7 +863,9 @@ export class ReclaimProofRequest {
                 const isIos = getMobileDeviceType() === DeviceType.IOS;
                 if (!isIos) {
                     let instantAppUrl = this.buildSharePageUrl(template);
-                    if (await this.isNewLinkingEnabledAsync) {
+                    const isDeferredDeeplinksFlowEnabled = options.canUseDeferredDeepLinksFlow ?? false;
+
+                    if (isDeferredDeeplinksFlowEnabled) {
                         instantAppUrl = instantAppUrl.replace("/verifier", "/link");
                     }
                     logger.info('Instant App Url created successfully: ' + instantAppUrl);
@@ -897,6 +895,7 @@ export class ReclaimProofRequest {
      * - Mobile Android: Redirects to Instant App
      * - Mobile iOS: Redirects to App Clip
      *
+     * @param launchOptions - Optional launch configuration to override default behavior
      * @returns Promise<void>
      * @throws {SignatureNotFoundError} When signature is not set
      *
@@ -906,7 +905,9 @@ export class ReclaimProofRequest {
      * // The appropriate verification method will be triggered automatically
      * ```
      */
-    async triggerReclaimFlow(): Promise<void> {
+    async triggerReclaimFlow(launchOptions?: ReclaimFlowLaunchOptions): Promise<void> {
+        const options = launchOptions || this.options?.launchOptions || {};
+
         if (!this.signature) {
             throw new SignatureNotFoundError('Signature is not set.')
         }
@@ -941,7 +942,7 @@ export class ReclaimProofRequest {
                 if (mobileDeviceType === DeviceType.ANDROID) {
                     // Redirect to instant app URL
                     logger.info('Redirecting to Android instant app');
-                    await this.redirectToInstantApp();
+                    await this.redirectToInstantApp(options);
                 } else if (mobileDeviceType === DeviceType.IOS) {
                     // Redirect to app clip URL
                     logger.info('Redirecting to iOS app clip');
@@ -1027,7 +1028,7 @@ export class ReclaimProofRequest {
         }
     }
 
-    private async redirectToInstantApp(): Promise<void> {
+    private async redirectToInstantApp(options: ReclaimFlowLaunchOptions): Promise<void> {
         try {
             let template = encodeURIComponent(JSON.stringify(this.templateData));
             template = replaceAll(template, '(', '%28');
@@ -1036,7 +1037,9 @@ export class ReclaimProofRequest {
             let instantAppUrl = this.buildSharePageUrl(template);
             logger.info('Redirecting to Android instant app: ' + instantAppUrl);
 
-            if (await this.isNewLinkingEnabledAsync) {
+            const isDeferredDeeplinksFlowEnabled = options.canUseDeferredDeepLinksFlow ?? false;
+
+            if (isDeferredDeeplinksFlowEnabled) {
                 instantAppUrl = instantAppUrl.replace("/verifier", "/link");
 
                 // Construct Android intent deep link
@@ -1123,11 +1126,10 @@ export class ReclaimProofRequest {
             // Redirect to app clip
             window.location.href = appClipUrl;
 
-            if (Features.isFirstAttemptToLaunchAppClip()) {
-                setTimeout(() => {
-                    window.location.href = appClipUrl;
-                }, 2000);
-            }
+            setTimeout(() => {
+                window.location.href = appClipUrl;
+                // 5 second delay to allow app clip to launch
+            }, 5 * 1000);
         } catch (error) {
             logger.info('Error redirecting to app clip:', error);
             throw error;

src/utils/apis/feature.ts

@@ -38,9 +38,26 @@ export type ProofRequestOptions = {
   extensionID?: string;
   providerVersion?: string;
   customSharePageUrl?: string;
-  customAppClipUrl?: string
+  customAppClipUrl?: string;
+  launchOptions?: ReclaimFlowLaunchOptions;
 };
 
+export type ReclaimFlowLaunchOptions = {
+  /**
+   * Enables deferred deep links for the Reclaim verification flow.
+   *
+   * When enabled, users without the verifier app installed will receive a deferred deep link
+   * that automatically launches the verification flow after they install the app, ensuring
+   * a seamless continuation of the verification process.
+   *
+   * **Platform Support:** Currently Android only
+   *
+   * **Default Behavior:** Opt-in during rollout phase. Will default to `true` for all apps
+   * once fully released. See: https://blog.reclaimprotocol.org/posts/moving-beyond-google-play-instant
+   */
+  canUseDeferredDeepLinksFlow?: boolean;
+}
+
 // Modal customization options
 export type ModalOptions = {
   title?: string;