purchasekit 0.4.5 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b1a96aa9528fbd3b75db3c4b8846925eec2ad386d3880e8eee945419394e9f33
-  data.tar.gz: 63d645c076363e6a8f8798925d5e9e988e0870938302a5c171534a3f9d4b6935
+  metadata.gz: 262fd99889485c18c0d9d668d930fc0cec3b258620396ef960b8d8828a040e29
+  data.tar.gz: 2b07a7abf7c580e72f98896e8e0a87a2cd7008cccbddbac8ba5d481e12c7308d
 SHA512:
-  metadata.gz: 87b85b9254ee1c59e2d65eb9f57e8f9aa851b7eea87f9576252e4679f85667036b979de0bc8ddefabe415de27125f846e71e64156ea7dc5b3a6404b006936862
-  data.tar.gz: 2a55629192a0b7aa000d3c43f6dec35c34ef0854338c3b7f6814877cbbd93dd291c504fde26caab396245bc6142c51259ec8832b03c1f735e2ff30fe78e3058a
+  metadata.gz: 66ac5a6194010cfaa573d54eaa11df03a6000778e3d828b35476d12d6ba4474ce233018043adcd166187ab309db3dd009d65b9759d36019c6f48391b5672fd21
+  data.tar.gz: a2385ee1ef72d178fe0354f0631a6cc4d258ebcedb2f3ae1a779974b6b9698079bd68854286bf30288ef1cb4284187abfc9000228a18569678a4466a706354e1

data/README.md

@@ -140,12 +140,23 @@ Build a paywall using the included helper. Subscribe to the Turbo Stream for rea
   <% end %>
 
   <%= paywall.submit "Subscribe" %>
+  <%= paywall.restore url: restore_purchases_path, class: "btn btn-link" %>
 <% end %>
+```
+
+### Restore purchases
+
+Apple requires apps with in-app purchases to include a "Restore purchases" button. This handles users who switch devices or reinstall the app.
 
-<%= button_to "Restore purchases", restore_purchases_path %>
+The `paywall.restore` helper renders a button that reads active subscriptions directly from StoreKit (iOS) or Play Billing (Android) via the native bridge. Pass a `url:` to automatically POST the subscription IDs to your server:
+
+```erb
+<%= paywall.restore url: restore_purchases_path, class: "btn btn-link" %>
 ```
 
-The restore link checks your server for an active subscription. Implement the endpoint in your app:
+When the user taps restore, the JS controller sends a bridge message to the native app, receives the active subscription IDs, and POSTs them as JSON to your URL. If the server responds with a redirect, the page navigates automatically.
+
+On the server, match the IDs against your stored subscriptions. The `subscription_ids` match the `subscription_id` field in PurchaseKit webhook payloads (Apple's `originalTransactionId`, Google's order ID):
 
 ```ruby
 # routes.rb
@@ -153,7 +164,9 @@ post "restore_purchases", to: "subscriptions#restore"
 
 # subscriptions_controller.rb
 def restore
-  if current_user.subscribed?
+  ids = params[:subscription_ids] || []
+
+  if ids.any? && current_user.subscriptions.where(processor_id: ids).active.any?
     redirect_to dashboard_path, notice: "Your subscription is active."
   else
     redirect_to paywall_path, alert: "No active subscription found."
@@ -161,6 +174,15 @@ def restore
 end
 ```
 
+If you need custom behavior, omit the `url:` and listen for the DOM event instead:
+
+```javascript
+document.addEventListener("purchasekit--paywall:restore", (event) => {
+  const { subscriptionIds, error } = event.detail
+  // Handle as needed
+})
+```
+
 Products are fetched from the PurchaseKit API:
 
 ```ruby

data/app/helpers/purchase_kit/paywall_helper.rb

@@ -85,5 +85,15 @@ module PurchaseKit
       @template.submit_tag(text, disabled: true, data: data, **options)
     end
 
+    def restore(text = "Restore purchases", url: nil, **options)
+      data = (options.delete(:data) || {}).merge(
+        purchasekit__paywall_target: "restoreButton",
+        action: "purchasekit--paywall#restore"
+      )
+      data[:restore_url] = url if url
+
+      @template.content_tag(:button, text, type: "button", data: data, **options)
+    end
+
   end
 end

data/app/javascript/controllers/purchasekit/paywall_controller.js

@@ -2,7 +2,7 @@ import { BridgeComponent } from "@hotwired/hotwire-native-bridge"
 
 export default class extends BridgeComponent {
   static component = "paywall"
-  static targets = ["planRadio", "price", "submitButton", "response", "environment"]
+  static targets = ["planRadio", "price", "submitButton", "response", "environment", "restoreButton"]
 
   connect() {
     super.connect()
@@ -15,6 +15,26 @@ export default class extends BridgeComponent {
     }
   }
 
+  restore() {
+    if (this.hasRestoreButtonTarget) {
+      this.restoreButtonTarget.disabled = true
+    }
+
+    this.send("restore", {}, message => {
+      if (this.hasRestoreButtonTarget) {
+        this.restoreButtonTarget.disabled = false
+      }
+
+      const { subscriptionIds, error } = message.data
+      this.dispatch("restore", { detail: { subscriptionIds, error } })
+
+      const restoreUrl = this.hasRestoreButtonTarget && this.restoreButtonTarget.dataset.restoreUrl
+      if (!error && restoreUrl) {
+        this.#submitRestore(restoreUrl, subscriptionIds || [])
+      }
+    })
+  }
+
   responseTargetConnected(element) {
     const error = element.dataset.error
 
@@ -62,6 +82,26 @@ export default class extends BridgeComponent {
     })
   }
 
+  #submitRestore(url, subscriptionIds) {
+    const csrfToken = document.querySelector("meta[name=csrf-token]")?.content
+
+    fetch(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...(csrfToken && { "X-CSRF-Token": csrfToken })
+      },
+      body: JSON.stringify({ subscription_ids: subscriptionIds })
+    }).then(response => {
+      if (response.redirected) {
+        window.Turbo.visit(response.url)
+      }
+    }).catch(error => {
+      console.error("Restore request failed:", error)
+      alert("Something went wrong restoring purchases. Please try again.")
+    })
+  }
+
   #fallbackTimeoutId = null
 
   #fetchPrices() {

data/lib/purchasekit/version.rb

@@ -1,3 +1,3 @@
 module PurchaseKit
-  VERSION = "0.4.5"
+  VERSION = "0.5.0"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: purchasekit
 version: !ruby/object:Gem::Version
-  version: 0.4.5
+  version: 0.5.0
 platform: ruby
 authors:
 - Joe Masilotti
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-02-11 00:00:00.000000000 Z
+date: 2026-02-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails