feat: alternative billing support (#15)

hyochan · web-flow · commit 873b7e1ce8c5 · 2025-10-02T10:31:57.000+09:00
diff --git a/Example/Martie.xcodeproj/project.pbxproj b/Example/Martie.xcodeproj/project.pbxproj
@@ -7,12 +7,13 @@
 	objects = {
 
 /* Begin PBXBuildFile section */
+		3472D7D42E8CFCB100C0714E /* AlternativeBillingScreen.swift in Sources */ = {isa = PBXBuildFile; fileRef = 3472D7D32E8CFCB100C0714E /* AlternativeBillingScreen.swift */; };
+		C0APV0022D20000000000001 /* AllProductsView.swift in Sources */ = {isa = PBXBuildFile; fileRef = C0APV0012D20000000000001 /* AllProductsView.swift */; };
 		C0E1F5E92C8F1A9400123456 /* OpenIapExampleApp.swift in Sources */ = {isa = PBXBuildFile; fileRef = C0E1F5E82C8F1A9400123456 /* OpenIapExampleApp.swift */; };
 		C0E1F5EB2C8F1A9400123456 /* ContentView.swift in Sources */ = {isa = PBXBuildFile; fileRef = C0E1F5EA2C8F1A9400123456 /* ContentView.swift */; };
 		C0E1F5ED2C8F1A9500123456 /* Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = C0E1F5EC2C8F1A9500123456 /* Assets.xcassets */; };
 		C0E1F5F02C8F1A9500123456 /* Preview Assets.xcassets in Resources */ = {isa = PBXBuildFile; fileRef = C0E1F5EF2C8F1A9500123456 /* Preview Assets.xcassets */; };
 		C0E1F5F82C8F1AA300123456 /* HomeScreen.swift in Sources */ = {isa = PBXBuildFile; fileRef = C0E1F5F72C8F1AA300123456 /* HomeScreen.swift */; };
-		C0APV0022D20000000000001 /* AllProductsView.swift in Sources */ = {isa = PBXBuildFile; fileRef = C0APV0012D20000000000001 /* AllProductsView.swift */; };
 		C0E1F5FA2C8F1AAB00123456 /* PurchaseFlowScreen.swift in Sources */ = {isa = PBXBuildFile; fileRef = C0E1F5F92C8F1AAB00123456 /* PurchaseFlowScreen.swift */; };
 		C0E1F5FC2C8F1AB000123456 /* SubscriptionFlowScreen.swift in Sources */ = {isa = PBXBuildFile; fileRef = C0E1F5FB2C8F1AB000123456 /* SubscriptionFlowScreen.swift */; };
 		C0E1F5FE2C8F1AB500123456 /* AvailablePurchasesScreen.swift in Sources */ = {isa = PBXBuildFile; fileRef = C0E1F5FD2C8F1AB500123456 /* AvailablePurchasesScreen.swift */; };
@@ -39,6 +40,8 @@
 /* End PBXBuildFile section */
 
 /* Begin PBXFileReference section */
+		3472D7D32E8CFCB100C0714E /* AlternativeBillingScreen.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AlternativeBillingScreen.swift; sourceTree = "<group>"; };
+		C0APV0012D20000000000001 /* AllProductsView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AllProductsView.swift; sourceTree = "<group>"; };
 		C0E1F5E52C8F1A9400123456 /* OpenIapExample.app */ = {isa = PBXFileReference; explicitFileType = wrapper.application; includeInIndex = 0; path = OpenIapExample.app; sourceTree = BUILT_PRODUCTS_DIR; };
 		C0E1F5E82C8F1A9400123456 /* OpenIapExampleApp.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = OpenIapExampleApp.swift; sourceTree = "<group>"; };
 		C0E1F5EA2C8F1A9400123456 /* ContentView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = ContentView.swift; sourceTree = "<group>"; };
@@ -49,7 +52,6 @@
 		C0E1F5FB2C8F1AB000123456 /* SubscriptionFlowScreen.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = SubscriptionFlowScreen.swift; sourceTree = "<group>"; };
 		C0E1F5FD2C8F1AB500123456 /* AvailablePurchasesScreen.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AvailablePurchasesScreen.swift; sourceTree = "<group>"; };
 		C0E1F5FF2C8F1ABA00123456 /* OfferCodeScreen.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = OfferCodeScreen.swift; sourceTree = "<group>"; };
-		C0APV0012D20000000000001 /* AllProductsView.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AllProductsView.swift; sourceTree = "<group>"; };
 		C0E1F6032C8F1AC500123456 /* AppColors.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = AppColors.swift; sourceTree = "<group>"; };
 		C0IAC0002D10000000000001 /* IapCompat.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = IapCompat.swift; sourceTree = "<group>"; };
 		C0UI10012D00000000000001 /* FeatureCard.swift */ = {isa = PBXFileReference; lastKnownFileType = sourcecode.swift; path = FeatureCard.swift; sourceTree = "<group>"; };
@@ -126,6 +128,7 @@
 				C0UI20012D00000000000001 /* uis */,
 				C0E1F5F72C8F1AA300123456 /* HomeScreen.swift */,
 				C0APV0012D20000000000001 /* AllProductsView.swift */,
+				3472D7D32E8CFCB100C0714E /* AlternativeBillingScreen.swift */,
 				C0E1F5F92C8F1AAB00123456 /* PurchaseFlowScreen.swift */,
 				C0E1F5FB2C8F1AB000123456 /* SubscriptionFlowScreen.swift */,
 				C0E1F5FD2C8F1AB500123456 /* AvailablePurchasesScreen.swift */,
@@ -263,6 +266,7 @@
 				C0UI00022D00000000000002 /* LoadingCard.swift in Sources */,
 				C0UI00032D00000000000003 /* EmptyStateCard.swift in Sources */,
 				C0UI00042D00000000000004 /* SectionHeaderView.swift in Sources */,
+				3472D7D42E8CFCB100C0714E /* AlternativeBillingScreen.swift in Sources */,
 				C0UI00052D00000000000005 /* ProductListCard.swift in Sources */,
 				C0UI00062D00000000000006 /* ProductGridCard.swift in Sources */,
 				C0UI00072D00000000000007 /* ActivePurchaseCard.swift in Sources */,
diff --git a/Example/OpenIapExample/Screens/HomeScreen.swift b/Example/OpenIapExample/Screens/HomeScreen.swift
@@ -61,30 +61,40 @@ struct HomeScreen: View {
                             color: Color.teal,
                             destination: AnyView(PurchaseFlowScreen())
                         )
-                        
+
                         FeatureCard(
-                            title: "Subscription\nFlow", 
+                            title: "Subscription\nFlow",
                             subtitle: "Test subscriptions",
                             icon: "repeat.circle.fill",
                             color: AppColors.secondary,
                             destination: AnyView(SubscriptionFlowScreen())
                         )
-                        
+
                         FeatureCard(
                             title: "My\nPurchases",
                             subtitle: "View your purchases",
                             icon: "list.bullet.rectangle.fill",
                             color: AppColors.success,
                             destination: AnyView(AvailablePurchasesScreen())
                         )
-                        
+
                         FeatureCard(
                             title: "Offer\nCode",
                             subtitle: "Redeem promotional codes",
                             icon: "gift.fill",
                             color: AppColors.warning,
                             destination: AnyView(OfferCodeScreen())
                         )
+
+                        if #available(iOS 16.0, *) {
+                            FeatureCard(
+                                title: "Alternative\nBilling",
+                                subtitle: "External purchase links",
+                                icon: "link.circle.fill",
+                                color: Color.purple,
+                                destination: AnyView(AlternativeBillingScreen())
+                            )
+                        }
                     }
                     .padding(.horizontal)
                     
diff --git a/Sources/Models/Types.swift b/Sources/Models/Types.swift
@@ -526,19 +526,39 @@ public struct RequestPurchaseIosProps: Codable {
     public var andDangerouslyFinishTransactionAutomatically: Bool?
     /// App account token for user tracking
     public var appAccountToken: String?
+    /// External purchase URL for alternative billing on iOS
+    public var externalPurchaseUrlOnIOS: String?
     /// Purchase quantity
     public var quantity: Int?
     /// Product SKU
     public var sku: String
     /// Discount offer to apply
     public var withOffer: DiscountOfferInputIOS?
+
+    public init(
+        andDangerouslyFinishTransactionAutomatically: Bool? = nil,
+        appAccountToken: String? = nil,
+        externalPurchaseUrlOnIOS: String? = nil,
+        quantity: Int? = nil,
+        sku: String,
+        withOffer: DiscountOfferInputIOS? = nil
+    ) {
+        self.andDangerouslyFinishTransactionAutomatically = andDangerouslyFinishTransactionAutomatically
+        self.appAccountToken = appAccountToken
+        self.externalPurchaseUrlOnIOS = externalPurchaseUrlOnIOS
+        self.quantity = quantity
+        self.sku = sku
+        self.withOffer = withOffer
+    }
 }
 
 public struct RequestPurchaseProps: Codable {
     public var request: Request
     public var type: ProductQueryType
+    /// Enable alternative billing flow
+    public var useAlternativeBilling: Bool?
 
-    public init(request: Request, type: ProductQueryType? = nil) {
+    public init(request: Request, type: ProductQueryType? = nil, useAlternativeBilling: Bool? = nil) {
         switch request {
         case .purchase:
             let resolved = type ?? .inApp
@@ -550,17 +570,20 @@ public struct RequestPurchaseProps: Codable {
             self.type = resolved
         }
         self.request = request
+        self.useAlternativeBilling = useAlternativeBilling
     }
 
     private enum CodingKeys: String, CodingKey {
         case requestPurchase
         case requestSubscription
         case type
+        case useAlternativeBilling
     }
 
     public init(from decoder: Decoder) throws {
         let container = try decoder.container(keyedBy: CodingKeys.self)
         let decodedType = try container.decodeIfPresent(ProductQueryType.self, forKey: .type)
+        self.useAlternativeBilling = try container.decodeIfPresent(Bool.self, forKey: .useAlternativeBilling)
         if let purchase = try container.decodeIfPresent(RequestPurchasePropsByPlatforms.self, forKey: .requestPurchase) {
             let finalType = decodedType ?? .inApp
             guard finalType == .inApp else {
@@ -604,6 +627,11 @@ public struct RequestPurchasePropsByPlatforms: Codable {
     public var android: RequestPurchaseAndroidProps?
     /// iOS-specific purchase parameters
     public var ios: RequestPurchaseIosProps?
+
+    public init(android: RequestPurchaseAndroidProps? = nil, ios: RequestPurchaseIosProps? = nil) {
+        self.android = android
+        self.ios = ios
+    }
 }
 
 public struct RequestSubscriptionAndroidProps: Codable {
@@ -626,16 +654,39 @@ public struct RequestSubscriptionAndroidProps: Codable {
 public struct RequestSubscriptionIosProps: Codable {
     public var andDangerouslyFinishTransactionAutomatically: Bool?
     public var appAccountToken: String?
+    /// External purchase URL for alternative billing on iOS
+    public var externalPurchaseUrlOnIOS: String?
     public var quantity: Int?
     public var sku: String
     public var withOffer: DiscountOfferInputIOS?
+
+    public init(
+        andDangerouslyFinishTransactionAutomatically: Bool? = nil,
+        appAccountToken: String? = nil,
+        externalPurchaseUrlOnIOS: String? = nil,
+        quantity: Int? = nil,
+        sku: String,
+        withOffer: DiscountOfferInputIOS? = nil
+    ) {
+        self.andDangerouslyFinishTransactionAutomatically = andDangerouslyFinishTransactionAutomatically
+        self.appAccountToken = appAccountToken
+        self.externalPurchaseUrlOnIOS = externalPurchaseUrlOnIOS
+        self.quantity = quantity
+        self.sku = sku
+        self.withOffer = withOffer
+    }
 }
 
 public struct RequestSubscriptionPropsByPlatforms: Codable {
     /// Android-specific subscription parameters
     public var android: RequestSubscriptionAndroidProps?
     /// iOS-specific subscription parameters
     public var ios: RequestSubscriptionIosProps?
+
+    public init(android: RequestSubscriptionAndroidProps? = nil, ios: RequestSubscriptionIosProps? = nil) {
+        self.android = android
+        self.ios = ios
+    }
 }
 
 // MARK: - Unions
diff --git a/Sources/OpenIapModule+ObjC.swift b/Sources/OpenIapModule+ObjC.swift
@@ -456,22 +456,22 @@ import StoreKit
             let dictionary = OpenIapSerialization.purchase(purchase)
             callback(dictionary as NSDictionary)
         }
-        return subscription as! NSObject
+        return subscription as NSObject
     }
 
     @objc func addPurchaseErrorListener(_ callback: @escaping (NSDictionary) -> Void) -> NSObject {
         let subscription = purchaseErrorListener { error in
             let dictionary = OpenIapSerialization.encode(error)
             callback(dictionary as NSDictionary)
         }
-        return subscription as! NSObject
+        return subscription as NSObject
     }
 
     @objc func addPromotedProductListener(_ callback: @escaping (String?) -> Void) -> NSObject {
         let subscription = promotedProductListenerIOS { sku in
             callback(sku)
         }
-        return subscription as! NSObject
+        return subscription as NSObject
     }
 
     @objc func removeListener(_ subscription: NSObject) {
diff --git a/Sources/OpenIapModule.swift b/Sources/OpenIapModule.swift
@@ -162,6 +162,25 @@ public final class OpenIapModule: NSObject, OpenIapModuleProtocol {
         try await ensureConnection()
         let iosProps = try resolveIosPurchaseProps(from: params)
         let sku = iosProps.sku
+
+        // Check for alternative billing with external purchase URL
+        if let externalUrl = iosProps.externalPurchaseUrlOnIOS,
+           params.useAlternativeBilling == true {
+            #if os(iOS)
+            if #available(iOS 16.0, *) {
+                return try await handleExternalPurchase(url: externalUrl, sku: sku)
+            } else {
+                let error = makePurchaseError(code: .featureNotSupported, productId: sku, message: "External purchase links require iOS 16.0 or later")
+                emitPurchaseError(error)
+                throw error
+            }
+            #else
+            let error = makePurchaseError(code: .featureNotSupported, productId: sku, message: "External purchase links are only supported on iOS")
+            emitPurchaseError(error)
+            throw error
+            #endif
+        }
+
         let product = try await storeProduct(for: sku)
         let options = StoreKitTypesBridge.purchaseOptions(from: iosProps)
 
@@ -643,6 +662,36 @@ public final class OpenIapModule: NSObject, OpenIapModuleProtocol {
 
     // MARK: - Private Helpers
 
+    #if os(iOS)
+    @available(iOS 16.0, *)
+    private func handleExternalPurchase(url: String, sku: String) async throws -> RequestPurchaseResult? {
+        guard let externalUrl = URL(string: url) else {
+            let error = makePurchaseError(code: .purchaseError, productId: sku, message: "Invalid external purchase URL")
+            emitPurchaseError(error)
+            throw error
+        }
+
+        // Open the external URL using UIApplication
+        let canOpen = await MainActor.run {
+            UIApplication.shared.canOpenURL(externalUrl)
+        }
+
+        guard canOpen else {
+            let error = makePurchaseError(code: .purchaseError, productId: sku, message: "Cannot open external purchase URL")
+            emitPurchaseError(error)
+            throw error
+        }
+
+        await MainActor.run {
+            UIApplication.shared.open(externalUrl, options: [:], completionHandler: nil)
+        }
+
+        // Return nil as the purchase is handled externally
+        // The actual purchase completion should be handled by the external website
+        return nil
+    }
+    #endif
+
     private func ensureConnection() async throws {
         if await state.isInitialized == false {
             _ = try await initConnection()
@@ -709,6 +758,7 @@ public final class OpenIapModule: NSObject, OpenIapModuleProtocol {
                 return RequestPurchaseIosProps(
                     andDangerouslyFinishTransactionAutomatically: ios.andDangerouslyFinishTransactionAutomatically,
                     appAccountToken: ios.appAccountToken,
+                    externalPurchaseUrlOnIOS: ios.externalPurchaseUrlOnIOS,
                     quantity: ios.quantity,
                     sku: ios.sku,
                     withOffer: ios.withOffer
diff --git a/Sources/OpenIapVersion.swift b/Sources/OpenIapVersion.swift
@@ -19,7 +19,7 @@ public struct OpenIapVersion {
             return version
         }
         // Fallback to hardcoded version
-        return "1.2.5"
+        return "1.0.10"
     }()
 
     private static func loadVersionFromJSON() -> String? {

Original file line number	Diff line number	Diff line change
`@@ -456,22 +456,22 @@ import StoreKit`
`456`	`456`	`let dictionary = OpenIapSerialization.purchase(purchase)`
`457`	`457`	`callback(dictionary as NSDictionary)`
`458`	`458`	`}`
`459`		`- return subscription as! NSObject`
	`459`	`+ return subscription as NSObject`
`460`	`460`	`}`
`461`	`461`
`462`	`462`	`@objc func addPurchaseErrorListener(_ callback: @escaping (NSDictionary) -> Void) -> NSObject {`
`463`	`463`	`let subscription = purchaseErrorListener { error in`
`464`	`464`	`let dictionary = OpenIapSerialization.encode(error)`
`465`	`465`	`callback(dictionary as NSDictionary)`
`466`	`466`	`}`
`467`		`- return subscription as! NSObject`
	`467`	`+ return subscription as NSObject`
`468`	`468`	`}`
`469`	`469`
`470`	`470`	`@objc func addPromotedProductListener(_ callback: @escaping (String?) -> Void) -> NSObject {`
`471`	`471`	`let subscription = promotedProductListenerIOS { sku in`
`472`	`472`	`callback(sku)`
`473`	`473`	`}`
`474`		`- return subscription as! NSObject`
	`474`	`+ return subscription as NSObject`
`475`	`475`	`}`
`476`	`476`
`477`	`477`	`@objc func removeListener(_ subscription: NSObject) {`
Original file line number	Diff line number	Diff line change
`@@ -19,7 +19,7 @@ public struct OpenIapVersion {`
`19`	`19`	`return version`
`20`	`20`	`}`
`21`	`21`	`// Fallback to hardcoded version`
`22`		`- return "1.2.5"`
	`22`	`+ return "1.0.10"`
`23`	`23`	`}()`
`24`	`24`
`25`	`25`	`private static func loadVersionFromJSON() -> String? {`