Deprecate StoreSyncService

Author: danielsaidi

RELEASE_NOTES.md

@@ -13,17 +13,18 @@ This version makes StoreKitPlus use Swift 6.
 
 As a result of the Swift 6 transition, and due to data race problems, the store services no longer takes a context and keeps it in sync. This must be explicitly handled by the caller.
 
-Furthermore, the service model is drastically simplified in this version. Instead of having multiple service types, `StoreService` handles it all. Instead of composition, you can override any open function to modify the service behavior.
+Furthermore, the service model is drastically simplified in this version. Instead of having multiple service types, `StoreService` handles it all.
 
 ### ✨ Features
 
-* `StandardProductService` no longer accepts a context, and will no longer keep it in sync.
-* `StandardProductPurchaseService` no longer accepts a context, and will no longer keep it in sync.
+* `StoreService` has new `.standard` shorthands.
+* `StandardStoreService` no longer accepts a context, and will no longer keep it in sync.
 
 ### 🗑️ Deprecations
 
-* `StoreProductService` has been deprecated - just use `StoreService` instead.
-* `StorePurchaseService` has been deprecated - just use `StoreService` instead.
+* `StoreProductService` has been deprecated.
+* `StorePurchaseService` has been deprecated.
+* `StoreSyncService` has been deprecated.
 
 
 

Sources/StoreKitPlus/Services/StandardStoreService.swift

@@ -8,6 +8,29 @@
 
 import StoreKit
 
+public extension StoreService where Self == StandardStoreService {
+
+    /// Create a service instance for the provided IDs.
+    ///
+    /// - Parameters:
+    ///   - productIds: The IDs of the products to handle.
+    static func standard(
+        productIds: [String]
+    ) -> Self {
+        .init(productIds: productIds)
+    }
+
+    /// Create a service instance for the provided products.
+    ///
+    /// - Parameters:
+    ///   - products: The products to handle.
+    static func standard<Product: ProductRepresentable>(
+        products: [Product]
+    ) -> Self {
+        .init(products: products)
+    }
+}
+
 /// This class implements the ``StoreService`` protocol, and
 /// can be used to integrate with StoreKit.
 ///
@@ -30,8 +53,7 @@ open class StandardStoreService: StoreService {
         updateTransactionsOnLaunch()
     }
 
-    /// Create a service instance for the provided `products`,
-    /// that syncs any changes to the provided `context`.
+    /// Create a service instance for the provided products.
     ///
     /// - Parameters:
     ///   - products: The products to handle.
@@ -49,7 +71,9 @@ open class StandardStoreService: StoreService {
         try await Product.products(for: productIds)
     }
 
-    open func purchase(_ product: Product) async throws -> Product.PurchaseResult {
+    open func purchase(
+        _ product: Product
+    ) async throws -> Product.PurchaseResult {
         #if os(visionOS)
         throw StoreServiceError.unsupportedPlatform("This purchase operation is not supported in visionOS: Use @Environment(\\.purchase) instead.")
         #else
@@ -75,7 +99,9 @@ open class StandardStoreService: StoreService {
         return transactions
     }
 
-    open func syncStoreData(to context: StoreContext) async throws {
+    open func syncStoreData(
+        to context: StoreContext
+    ) async throws {
         let products = try await getProducts()
         await context.updateProducts(products)
         try await restorePurchases()

Sources/StoreKitPlus/Services/StoreService.swift

@@ -15,8 +15,31 @@ import StoreKit
 /// Although some operations can be performed directly using
 /// StoreKit like `Product.products(for:)`, the service lets
 /// you customize any part of the StoreKit integration.
-public protocol StoreService: StorePurchaseService, StoreSyncService {
+public protocol StoreService: StoreSyncService {
 
     /// Get all available products.
     func getProducts() async throws -> [Product]
+
+    /// Purchase a certain product.
+    func purchase(
+        _ product: Product
+    ) async throws -> Product.PurchaseResult
+
+    /// Restore previous purchases.
+    @discardableResult
+    func restorePurchases() async throws -> [Transaction]
+
+    /// Sync StoreKit products and purchases to a context.
+    func syncStoreData(
+        to context: StoreContext
+    ) async throws
 }
+
+public extension StoreService {
+
+    @available(*, deprecated, message: "You have to pass in a context now.")
+    func syncStoreData() async throws {
+        try await syncStoreData(to: .init())
+    }
+}
+

Sources/StoreKitPlus/_Deprecated/StorePurchaseService.swift

@@ -11,8 +11,5 @@ import StoreKit
 @available(*, deprecated, message: "Just use StoreService instead.")
 public protocol StorePurchaseService: AnyObject {
 
-    func purchase(_ product: Product) async throws -> Product.PurchaseResult
-
-    @discardableResult
-    func restorePurchases() async throws -> [Transaction]
+    
 }

Sources/StoreKitPlus/Services/StoreSyncService.swift Sources/StoreKitPlus/_Deprecated/StoreSyncService.swift

@@ -8,16 +8,15 @@
 
 import StoreKit
 
-/// This protocol can be implemented by any classes that can
-/// be used to sync StoreKit purchase & product information.
+@available(*, deprecated, message: "Just use StoreService instead.")
 public protocol StoreSyncService: AnyObject {
 
-    /// Sync StoreKit product and purchase information to a context.
     func syncStoreData(
         to context: StoreContext
     ) async throws
 }
 
+@available(*, deprecated, message: "Just use StoreService instead.")
 public extension StoreSyncService {
 
     @available(*, deprecated, message: "You have to pass in a context now.")