[Draft] Allow override of checkoutDiClickLink callback

modules/@shopify/checkout-sheet-kit/ios/ShopifyCheckoutSheetKit.swift

@@ -49,7 +49,7 @@
 	}
 
 	override func supportedEvents() -> [String]! {
-		return ["close", "completed", "error", "pixel"]
+		return ["close", "completed", "error", "pixel", "linkClick"]
 	}
 
 	override func startObserving() {
@@ -66,6 +66,13 @@
 		}
 	}
 
+ func checkoutDidClickLink(url: URL) {
+   if hasListeners {
+      let event: [String: String] = ["url": url.absoluteString]
+      self.sendEvent(withName: "linkClick", body: encodeToJSON(from: event))
+   }
+ }
+
 	func shouldRecoverFromError(error: CheckoutError) -> Bool {
 		return error.isRecoverable
 	}

modules/@shopify/checkout-sheet-kit/src/events.d.ts

@@ -110,3 +110,7 @@ namespace CheckoutCompletedEvent {
 export interface CheckoutCompletedEvent {
   orderDetails: CheckoutCompletedEvent.OrderDetails;
 }
+
+export interface CheckoutLinkClickEvent {
+  url: string;
+}

modules/@shopify/checkout-sheet-kit/src/index.d.ts

@@ -23,7 +23,7 @@ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SO
 
 import type {EmitterSubscription} from 'react-native';
 import type {PixelEvent} from './pixels';
-import type {CheckoutCompletedEvent} from './events';
+import type {CheckoutCompletedEvent, CheckoutLinkClickEvent} from './events';
 import type {CheckoutException} from './errors';
 
 export type Maybe<T> = T | undefined;
@@ -144,6 +144,7 @@ export type CheckoutEvent =
   | 'completed'
   | 'error'
   | 'geolocationRequest'
+  | 'linkClick'
   | 'pixel';
 
 export interface GeolocationRequestEvent {
@@ -159,11 +160,15 @@ export type CheckoutExceptionCallback = (error: CheckoutException) => void;
 export type CheckoutCompletedEventCallback = (
   event: CheckoutCompletedEvent,
 ) => void;
+export type CheckoutLinkClickEventCallback = (
+  event: CheckoutLinkClickEvent,
+) => void;
 
 export type CheckoutEventCallback =
   | CloseEventCallback
   | CheckoutExceptionCallback
   | CheckoutCompletedEventCallback
+  | CheckoutLinkClickEventCallback
   | GeolocationRequestEventCallback
   | PixelEventCallback;
 
@@ -177,6 +182,11 @@ function addEventListener(
   callback: CheckoutCompletedEventCallback,
 ): Maybe<EmitterSubscription>;
 
+function addEventListener(
+  event: 'linkClick',
+  callback: CheckoutLinkClickEventCallback,
+): Maybe<EmitterSubscription>;
+
 function addEventListener(
   event: 'error',
   callback: CheckoutExceptionCallback,

modules/@shopify/checkout-sheet-kit/src/index.ts

@@ -26,6 +26,7 @@ import {
   NativeEventEmitter,
   PermissionsAndroid,
   Platform,
+  Linking,
 } from 'react-native';
 import type {
   EmitterSubscription,
@@ -54,7 +55,7 @@ import {
   GenericError,
 } from './errors.d';
 import {CheckoutErrorCode} from './errors.d';
-import type {CheckoutCompletedEvent} from './events.d';
+import type {CheckoutCompletedEvent, CheckoutLinkClickEvent} from './events.d';
 import type {CustomEvent, PixelEvent, StandardEvent} from './pixels.d';
 
 const RNShopifyCheckoutSheetKit = NativeModules.ShopifyCheckoutSheetKit;
@@ -76,6 +77,7 @@ class ShopifyCheckoutSheet implements ShopifyCheckoutSheetKit {
   );
 
   private features: Features;
+  private linkClickCallback: Maybe<EventSubscription>;
   private geolocationCallback: Maybe<EventSubscription>;
 
   /**
@@ -99,6 +101,8 @@ class ShopifyCheckoutSheet implements ShopifyCheckoutSheetKit {
     ) {
       this.subscribeToGeolocationRequestPrompts();
     }
+
+    this.subscribeToLinkClicks();
   }
 
   public readonly version: string = RNShopifyCheckoutSheetKit.version;
@@ -172,6 +176,9 @@ class ShopifyCheckoutSheet implements ShopifyCheckoutSheetKit {
       case 'completed':
         eventCallback = this.interceptEventEmission('completed', callback);
         break;
+      case 'linkClick':
+        eventCallback = this.interceptEventEmission('linkClick', callback);
+        break;
       case 'error':
         eventCallback = this.interceptEventEmission(
           'error',
@@ -243,6 +250,20 @@ class ShopifyCheckoutSheet implements ShopifyCheckoutSheetKit {
     );
   }
 
+  private subscribeToLinkClicks() {
+    this.linkClickCallback = this.addEventListener(
+      'linkClick',
+      async (event: CheckoutLinkClickEvent) => {
+        const {url} = event;
+        const canOpenUrl = await Linking.canOpenURL(url);
+
+        if (canOpenUrl) {
+          await Linking.openURL(url);
+        }
+      },
+    );
+  }
+
   /**
    * Requests geolocation permissions on Android
    * @returns Promise<boolean> indicating if permission was granted