portage-ucp-bigcommerce 0.1.5 → 0.2.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 827a3c5e0887e26b4af0719da1bc0fb4117fa1f6c5e44d91b624bef64c4ad12a
-  data.tar.gz: c504143d11148ba0eec757a0ab77674264dbb6ee848297e663a3297e2e32b096
+  metadata.gz: 608b4a53ae0a7392f15442bba6232678962d390314e7174715ffca940dba6496
+  data.tar.gz: f55e4cbc4d56e73bc35c5368c59a8d2f831d2895b9110c03383fff81851384a8
 SHA512:
-  metadata.gz: 3eaa018e98764afe72b573252f93eb31f5fcce2886bd963d7ee6b7010db077810106924b94fb45137329a96ce59a33bb4939bb8910652303f34a9b80304be6f3
-  data.tar.gz: 48f1fc0ca46cbf12b42c65675a872c22a9646bed96c897dfae935304a63f64c27cde4ddf0e0613d1016768adffb28cd1b31bf1f01847be7368aade1c3dee5e12
+  metadata.gz: b76a1bd7332fc964e495da185bde5bc6943c7f2f193587fdcb9a5001d18ca01fe4f8284f25931cfe505809bd199c088fb02c48d1e667cf7bfd05bfdcb1b89283
+  data.tar.gz: e228f872c5e017b451074dc422b02a601b6b28908e8819211686b7c00508d51b83bd33c851b5ef8eeeb9385adcf8a6cfe7b95d6f5a576671ede013a81fb3c17b

data/CHANGELOG.md

@@ -6,6 +6,16 @@ pre-1.0, so APIs may still shift between minor versions.
 
 ## [Unreleased]
 
+## [0.2.1] - 2026-10-07
+
+- **Fixed: a checkout the shopper paid for in the browser now reads as `completed` from a new process.** Status lived only in the creating process, so `portage orders reconcile` always saw `incomplete`, and once BigCommerce deleted the paid cart, not-found. `#get_checkout` now asks v2 List Orders for an order with this `cart_id` in a paid status (Shipped, Awaiting Fulfillment, Completed and the like; not Awaiting Payment, Pending or Incomplete) and then reports `completed` with the `order` confirmation, rebuilding the checkout from that order if the cart is gone. No order, or a failed lookup, keeps `incomplete`/not-found. Needs `portage-ucp` 0.13.0 for the `CheckoutState` platform hook, so the gem now requires `portage-ucp` `~> 0.13`. Patch-level.
+
+## [0.2.0] - 2026-10-05
+
+- **Removed the unused `Client#v2_post` and `Client#v3_put`.** Nothing in the gem called them. They were public on the client class, so this is **breaking** for any caller using them directly; minor-level for a pre-1.0 gem.
+
+- **Removed `Mapper.money`.** It was a one-line pass-through to `Support::Amounts.money` that nothing in the gem called. It is a public module function, so this is **breaking** for any caller using it directly; minor-level for a pre-1.0 gem.
+
 ## [0.1.5] - 2026-09-29
 
 - Fixes a `NoMethodError` at launch: `exe/portage-ucp-bigcommerce` handed

data/exe/portage-ucp-bigcommerce

@@ -5,7 +5,8 @@
 # vars, and — since this gem ships with permissive-nothing defaults (see
 # README's "Security hooks") — wire a real Authenticator/RateLimiter/etc. via
 # a config file loaded with PORTAGE_UCP_CONFIG, the same way `rackup -r` or
-# Sidekiq's `-r` work — see ../examples/portage_ucp.rb for a starting point.
+# Sidekiq's `-r` work — see a starting point at
+# https://github.com/tomtom87/Portage/blob/main/portage-ucp/examples/portage_ucp.rb.
 # Without one, the server still starts but rejects every mutating call.
 #
 # BIGCOMMERCE_PAYMENT_GATEWAY_ID is optional — only needed to call

data/lib/portage/ucp/bigcommerce/adapter.rb

@@ -43,6 +43,16 @@ module Portage
         # than an empty body, which UCP's reads report as nil.
         include Portage::Ucp::Support::NotFound
 
+        # Order statuses that mean the shopper placed and paid the order
+        # (https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/order-status/get-order-statuses):
+        # 2 Shipped, 3 Partially Shipped, 4 Refunded, 8 Awaiting Pickup,
+        # 9 Awaiting Shipment, 10 Completed, 11 Awaiting Fulfillment ("payment
+        # has been confirmed"), 13 Disputed, 14 Partially Refunded. Left out:
+        # 0 Incomplete and 1 Pending (checkout not finished), 7 Awaiting
+        # Payment (not confirmed yet), 12 Manual Verification Required, and
+        # 5 Cancelled / 6 Declined, which stay pending rather than guess.
+        PLACED_ORDER_STATUS_IDS = [2, 3, 4, 8, 9, 10, 11, 13, 14].freeze
+
         def initialize(client:, site_url:, currency:, payment_gateway_id: nil)
           super()
           @client = client
@@ -114,11 +124,16 @@ module Portage
           end
         end
 
+        # A paid checkout's cart is deleted ("Once the order is paid, the
+        # cart is deleted", Create an Order docs), so a not-found here falls
+        # back to the order BigCommerce placed from it, if any (see
+        # #platform_checkout_order).
         def get_checkout(checkout_id:)
-          nil_on_not_found do
-            node = fetch_checkout_node(checkout_id)
-            node && Mapper.checkout(node, id: checkout_id, status: checkout_status(checkout_id))
-          end
+          node = nil_on_not_found { fetch_checkout_node(checkout_id) }
+          return checkout_from_platform_order(checkout_id) unless node
+
+          Mapper.checkout(node, id: checkout_id, status: checkout_status(checkout_id),
+                                order: checkout_order(checkout_id))
         end
 
         # Full replacement, same rationale as #update_cart — BigCommerce's
@@ -158,6 +173,20 @@ module Portage
 
         private
 
+        # Support::CheckoutState's platform hook. v2 List Orders filters on
+        # `cart_id`, "the cart ID from which this order originated", and the
+        # checkout id here *is* the cart id
+        # (https://docs.bigcommerce.com/developer/api-reference/rest/admin/management/orders/get-orders).
+        # v2 answers an empty list with 204 and no body, which parses as {}.
+        def platform_checkout_order(checkout_id)
+          orders = @client.v2_get("/orders?cart_id=#{URI.encode_www_form_component(checkout_id)}")
+          placed = Array(orders).find { |o| o.is_a?(Hash) && PLACED_ORDER_STATUS_IDS.include?(o["status_id"]) }
+          return nil unless placed
+
+          Mapper.order(placed, products: @client.v2_get("/orders/#{placed['id']}/products"), site_url: @site_url,
+                               checkout_id: checkout_id)
+        end
+
         def fetch_cart_node(cart_id)
           include_param = "line_items.physical_items.options,line_items.digital_items.options"
           @client.v3_get("/carts/#{cart_id}?include=#{include_param}")["data"]

data/lib/portage/ucp/bigcommerce/client.rb

@@ -39,10 +39,6 @@ module Portage
           admin_request(Net::HTTP::Get, "v2", path)
         end
 
-        def v2_post(path, body = {})
-          admin_request(Net::HTTP::Post, "v2", path, body)
-        end
-
         def v3_get(path)
           admin_request(Net::HTTP::Get, "v3", path)
         end
@@ -51,10 +47,6 @@ module Portage
           admin_request(Net::HTTP::Post, "v3", path, body)
         end
 
-        def v3_put(path, body = {})
-          admin_request(Net::HTTP::Put, "v3", path, body)
-        end
-
         def v3_delete(path)
           admin_request(Net::HTTP::Delete, "v3", path)
         end

data/lib/portage/ucp/bigcommerce/mapper.rb

@@ -13,10 +13,6 @@ module Portage
       module Mapper
         module_function
 
-        def money(amount, currency)
-          Portage::Ucp::Support::Amounts.money(amount, currency)
-        end
-
         def minor_units(amount)
           Portage::Ucp::Support::Amounts.decimal_to_minor(amount)
         end

data/lib/portage/ucp/bigcommerce/version.rb

@@ -1,7 +1,7 @@
 module Portage
   module Ucp
     module BigCommerce
-      VERSION = "0.1.5".freeze
+      VERSION = "0.2.1".freeze
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: portage-ucp-bigcommerce
 version: !ruby/object:Gem::Version
-  version: 0.1.5
+  version: 0.2.1
 platform: ruby
 authors:
 - Tom Whitbread
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-29 00:00:00.000000000 Z
+date: 2026-10-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: portage-ucp
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: '0.13'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.8'
+        version: '0.13'
 - !ruby/object:Gem::Dependency
   name: rspec
   requirement: !ruby/object:Gem::Requirement