purchasekit 0.6.1 → 0.7.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bfc4771e012ecaa84d79c4be751a4cca9f63ddb14629f4b6bc39bdace9d5ebb2
-  data.tar.gz: 476cedaf6b9f2ea02692b80d19ba69e2ad1bcad739f49a060b8acd1f222c7bcd
+  metadata.gz: 82311c2fb6a6a3aea1ffe6997cfece956e4aef5544fa2ef3cb5e4fcb5a8266d8
+  data.tar.gz: aa2785f59d913cade15b3bd0c1335326279673c0a9e519af90fdc22d9de37e90
 SHA512:
-  metadata.gz: b2573bd5d5d9b7e3ea17dfffc160fb430576ec70e6ed45ec12e93bedfa53c65e1a1d9e64a5eba0424cb97ed436538281af0720fe83e131bb61da602739b357d7
-  data.tar.gz: 85d0a42f2fec7137008599ed367e35d2083419df92b673943a8d8a20fcb539c4390581abca537c00b2ef58c5de74be1924a1084a4800ab7d57476e9f6d4f5f20
+  metadata.gz: 752531ead05262da654b7069194df36af97cc4c9dd7fa2c496d230bf637e356ba4aebc97b1d02e44bccd37b34836fcaf432929c7fe46041bb518002979738d0c
+  data.tar.gz: 131b2ecb97d17134ff6ecea92162422bf82c9d14e7c938f526ba31c245e47bafdc5d14a394818260598b137e1588aea45981a5dcbe42ee86c6bed25a9d5f5340

data/README.md

@@ -125,7 +125,36 @@ Webhooks may be delivered more than once. Write idempotent callbacks using `find
 
 ## Paywall helper
 
-Build a paywall using the included helper. Subscribe to the Turbo Stream for real-time redirects:
+Build a paywall using the included helper. Subscribe to a Turbo Stream channel for real-time redirects after purchase. The `customer_id` you pass flows through the store and back to your webhook handler, so it must match what the handler expects.
+
+### With Pay
+
+Pass the `Pay::Customer.id` (not your user ID), and subscribe to the Pay customer's `dom_id` channel:
+
+```erb
+<% pay_customer = current_user.set_payment_processor(:purchasekit) %>
+
+<%= turbo_stream_from dom_id(pay_customer) %>
+
+<%= purchasekit_paywall customer_id: pay_customer.id, success_path: dashboard_path do |paywall| %>
+  <%= paywall.plan_option product: @annual, selected: true do %>
+    Annual - <%= paywall.price %>/year
+  <% end %>
+
+  <%= paywall.plan_option product: @monthly do %>
+    Monthly - <%= paywall.price %>/month
+  <% end %>
+
+  <%= paywall.submit "Subscribe" %>
+  <%= paywall.restore url: restore_purchases_path, class: "btn btn-link" %>
+<% end %>
+```
+
+`set_payment_processor(:purchasekit)` finds or creates the `Pay::Customer` row. Calling it on every paywall render guarantees the row exists before the webhook tries to look it up.
+
+### Without Pay
+
+Use your own user ID for both the `customer_id` and the Turbo Stream channel:
 
 ```erb
 <%= turbo_stream_from "purchasekit_customer_#{current_user.id}" %>

data/app/controllers/purchase_kit/purchase/completions_controller.rb

@@ -19,7 +19,7 @@ module PurchaseKit
           subscription_name: "Demo Subscription",
           status: "active",
           current_period_start: Time.current.iso8601,
-          current_period_end: 1.year.from_now.iso8601,
+          current_period_end: 1.month.from_now.iso8601,
           ends_at: nil,
           success_path: intent.success_path
         }

data/app/controllers/purchase_kit/purchases_controller.rb

@@ -1,6 +1,8 @@
 module PurchaseKit
   class PurchasesController < ApplicationController
     def create
+      raise PurchaseKit::NotFoundError, "No product selected" if params[:product_id].blank?
+
       intent = PurchaseKit::Purchase::Intent.create(
         product_id: params[:product_id],
         customer_id: params[:customer_id],

data/app/helpers/purchase_kit/paywall_helper.rb

@@ -2,12 +2,15 @@ module PurchaseKit
   module PaywallHelper
     # Renders a paywall form that triggers native in-app purchases
     #
-    # @param customer_id [String, Integer] Your user/customer identifier
+    # @param customer_id [String, Integer] The identifier passed back in webhook
+    #   events. With Pay, this must be `Pay::Customer.id` (the webhook handler
+    #   does `Pay::Customer.find(customer_id)`). Without Pay, use your own user ID.
     # @param success_path [String] Where to redirect after successful purchase
     # @yield [PaywallBuilder] Builder for plan options and buttons
     #
-    # Example:
-    #   <%= purchasekit_paywall customer_id: current_user.id, success_path: dashboard_path do |paywall| %>
+    # Example (with Pay):
+    #   <% pay_customer = current_user.set_payment_processor(:purchasekit) %>
+    #   <%= purchasekit_paywall customer_id: pay_customer.id, success_path: dashboard_path do |paywall| %>
     #     <%= paywall.plan_option product: @annual, selected: true do %>
     #       Annual - <%= paywall.price %>
     #     <% end %>
@@ -48,6 +51,7 @@ module PurchaseKit
         selected,
         id: input_id,
         class: input_class,
+        required: true,
         autocomplete: "off",
         data: {
           purchasekit__paywall_target: "planRadio",

data/lib/purchasekit/events.rb

@@ -119,6 +119,11 @@ module PurchaseKit
         parse_time(payload[:ends_at])
       end
 
+      # When the trial period ends (nil if no trial)
+      def trial_ends_at
+        parse_time(payload[:trial_ends_at])
+      end
+
       # The success path you passed when creating the purchase intent.
       # Use this for redirecting after purchase completion.
       def success_path

data/lib/purchasekit/pay/webhooks/subscription_created.rb

@@ -21,6 +21,7 @@ module PurchaseKit
             quantity: 1,
             current_period_start: parse_time(event["current_period_start"]),
             current_period_end: parse_time(event["current_period_end"]),
+            trial_ends_at: parse_time(event["trial_ends_at"]),
             ends_at: parse_time(event["ends_at"]),
             data: (subscription.data || {}).merge("store" => event["store"])
           )

data/lib/purchasekit/pay/webhooks/subscription_updated.rb

@@ -6,20 +6,31 @@ module PurchaseKit
         include Turbo::Streams::ActionHelper
 
         def call(event)
-          update_subscription(event,
+          customer = ::Pay::Customer.find(event["customer_id"])
+
+          subscription = ::Pay::Purchasekit::Subscription.find_or_initialize_by(
+            customer: customer,
+            processor_id: event["subscription_id"]
+          )
+          subscription.name ||= event["subscription_name"] || ::Pay.default_product_name
+          subscription.quantity ||= 1
+
+          subscription.update!(
             processor_plan: event["store_product_id"],
             status: event["status"],
             current_period_start: parse_time(event["current_period_start"]),
             current_period_end: parse_time(event["current_period_end"]),
-            ends_at: parse_time(event["ends_at"]))
+            trial_ends_at: parse_time(event["trial_ends_at"]),
+            ends_at: parse_time(event["ends_at"]),
+            data: (subscription.data || {}).merge("store" => event["store"])
+          )
 
-          broadcast_redirect(event) if event["success_path"].present?
+          broadcast_redirect(customer, event) if event["success_path"].present?
         end
 
         private
 
-        def broadcast_redirect(event)
-          customer = ::Pay::Customer.find(event["customer_id"])
+        def broadcast_redirect(customer, event)
           Turbo::StreamsChannel.broadcast_stream_to(
             dom_id(customer),
             content: turbo_stream_action_tag(:redirect, url: event["success_path"])

data/lib/purchasekit/version.rb

@@ -1,3 +1,3 @@
 module PurchaseKit
-  VERSION = "0.6.1"
+  VERSION = "0.7.1"
 end

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: purchasekit
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.7.1
 platform: ruby
 authors:
 - Joe Masilotti
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2026-03-15 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rails
@@ -225,7 +224,6 @@ metadata:
   homepage_uri: https://purchasekit.com
   source_code_uri: https://github.com/purchasekit/purchasekit
   changelog_uri: https://github.com/purchasekit/purchasekit/blob/main/CHANGELOG.md
-post_install_message: 
 rdoc_options: []
 require_paths:
 - lib
@@ -240,8 +238,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3.1
-signing_key: 
+rubygems_version: 4.0.3
 specification_version: 4
 summary: In-app purchase infrastructure for Rails
 test_files: []