feat: apply renewalstate, error messages, md rules (#5)

Switch subscription status to StoreKit RenewalState and keep JSON
compatibility by encoding the enum as a string. Add default messages for
all error codes and expose an errorMessages() map for bridging. Also
fill missing error code mappings and disable markdownlint MD013/MD033
for the docs.

Author: hyochan

.markdownlint.json

@@ -0,0 +1,7 @@
+{
+  "default": true,
+  "MD013": false,
+  "line-length": false,
+  "MD033": false,
+  "no-inline-html": false
+}

Example/OpenIapExample/Screens/PurchaseFlowScreen.swift

@@ -282,15 +282,15 @@ struct PurchaseFlowScreen: View {
         }
     }
 
-    private func handlePurchaseError(_ error: PurchaseError) {
+    private func handlePurchaseError(_ error: OpenIapErrorEvent) {
         print("❌ [PurchaseFlow] Purchase error: \(error.message)")
 
         // Update UI state
         purchaseResultMessage = "❌ Purchase failed: \(error.message)"
         showPurchaseResult = true
 
         // Show error alert for non-cancellation errors
-        if error.code != PurchaseError.E_USER_CANCELLED {
+        if error.code != OpenIapError.E_USER_CANCELLED {
             errorMessage = error.message
             showError = true
         }

Example/OpenIapExample/Screens/SubscriptionFlowScreen.swift

@@ -324,9 +324,8 @@ struct SubscriptionFlowScreen: View {
         }
     }
 
-    private func handlePurchaseError(_ error: PurchaseError) {
+    private func handlePurchaseError(_ error: OpenIapErrorEvent) {
         print("❌ [SubscriptionFlow] Subscription error: \(error.message)")
         // Error status is already handled internally by OpenIapStore
     }
 }
-

Example/OpenIapExample/ViewModels/TransactionObserver.swift

@@ -49,7 +49,7 @@ class TransactionObserver: ObservableObject {
         errorMessage = nil
     }
 
-    private func handlePurchaseError(_ error: PurchaseError) {
+    private func handlePurchaseError(_ error: OpenIapErrorEvent) {
         print("❌ Purchase failed - Code: \(error.code), Message: \(error.message)")
         errorMessage = error.message
         isPending = false
@@ -96,4 +96,4 @@ struct TransactionObserverExampleView: View {
         formatter.timeStyle = .short
         return formatter
     }
-}
+}

README.md

@@ -109,7 +109,7 @@ import OpenIAP
 @MainActor
 class StoreViewModel: ObservableObject {
     private let iapProvider: OpenIapProvider
-    
+
     init() {
         // Setup provider with event handlers
         self.iapProvider = OpenIapProvider(
@@ -120,19 +120,19 @@ class StoreViewModel: ObservableObject {
                 print("Purchase failed: \(error.message)")
             }
         )
-        
+
         Task {
             // Initialize connection
             try await iapProvider.initConnection()
-            
+
             // Fetch products
             try await iapProvider.fetchProducts(
                 skus: ["product1", "product2"],
                 type: .inapp
             )
         }
     }
-    
+
     deinit {
         Task {
             // End connection when done
@@ -152,22 +152,22 @@ import OpenIAP
 @MainActor
 func setupStore() async throws {
     let module = OpenIapModule.shared
-    
+
     // Initialize connection first
     _ = try await module.initConnection()
-    
+
     // Setup listeners
     let subscription = module.purchaseUpdatedListener { purchase in
         print("Purchase updated: \(purchase.productId)")
     }
-    
+
     // Fetch and purchase
     let request = ProductRequest(skus: ["premium"], type: .all)
     let products = try await module.fetchProducts(request)
-    
+
     let props = RequestPurchaseProps(sku: "premium")
     let purchase = try await module.requestPurchase(props)
-    
+
     // When done, clean up
     module.removeListener(subscription)
     _ = try await module.endConnection()
@@ -179,7 +179,9 @@ func setupStore() async throws {
 OpenIAP now has a **simplified, minimal API** with just 2 main components:
 
 ### Core Components
-1. **OpenIapModule** (`OpenIapModule.swift`) 
+
+1. **OpenIapModule** (`OpenIapModule.swift`)
+
    - Core StoreKit 2 implementation
    - Static convenience methods for simple usage
    - Low-level instance methods for advanced control
@@ -191,6 +193,7 @@ OpenIAP now has a **simplified, minimal API** with just 2 main components:
    - Perfect for MVVM architecture
 
 ### Why This Design?
+
 - **No Duplication**: Each component has a distinct purpose
 - **Flexibility**: Use global functions, static methods, or instances
 - **Simplicity**: Only 2 files to understand instead of 4+
@@ -266,17 +269,17 @@ The library provides explicit connection management with automatic listener clea
 ```swift
 class StoreViewModel: ObservableObject {
     private let iapProvider = OpenIapProvider()
-    
+
     init() {
         Task {
             // Initialize connection
             try await iapProvider.initConnection()
-            
+
             // Fetch products
             try await iapProvider.fetchProducts(skus: productIds)
         }
     }
-    
+
     deinit {
         Task {
             // End connection (listeners cleaned up automatically)

Sources/Models/OpenIapAppTransaction.swift

@@ -51,8 +51,40 @@ extension OpenIapAppTransaction {
 }
 
 public struct OpenIapSubscriptionStatus: Codable, Sendable {
-    public let state: String
+    public let state: Product.SubscriptionInfo.RenewalState
     public let renewalInfo: OpenIapRenewalInfo?
+
+    enum CodingKeys: String, CodingKey {
+        case state
+        case renewalInfo
+    }
+
+    public init(state: Product.SubscriptionInfo.RenewalState, renewalInfo: OpenIapRenewalInfo?) {
+        self.state = state
+        self.renewalInfo = renewalInfo
+    }
+
+    // Encode enum as string for JSON compatibility
+    public func encode(to encoder: Encoder) throws {
+        var container = encoder.container(keyedBy: CodingKeys.self)
+        try container.encode(String(describing: state), forKey: .state)
+        try container.encodeIfPresent(renewalInfo, forKey: .renewalInfo)
+    }
+
+    // Decode state from string into known cases; fallback to .expired
+    public init(from decoder: Decoder) throws {
+        let container = try decoder.container(keyedBy: CodingKeys.self)
+        let raw = (try? container.decode(String.self, forKey: .state))?.lowercased()
+        switch raw {
+        case "subscribed": self.state = .subscribed
+        case "expired": self.state = .expired
+        case "inbillingretryperiod": self.state = .inBillingRetryPeriod
+        case "ingraceperiod": self.state = .inGracePeriod
+        case "revoked": self.state = .revoked
+        default: self.state = .expired
+        }
+        self.renewalInfo = try container.decodeIfPresent(OpenIapRenewalInfo.self, forKey: .renewalInfo)
+    }
 }
 
 public struct OpenIapRenewalInfo: Codable, Sendable {
@@ -92,4 +124,3 @@ public struct OpenIapPriceLocale: Codable, Sendable {
     public let currencySymbol: String
     public let countryCode: String
 }
-