openreceive-server 0.2.2 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fab55d2a945025a4385ca22446b7294709abfbd114fe8c096fbd78f6a6c05412
-  data.tar.gz: 82e04197ecfa6c41b41e2254454319bc1010af1dbb3b037cd625a68fbda9e852
+  metadata.gz: 709f10b4ec4f14ebd43b63977d10ea992365c3329e81b5eb1ebe02b004dce2db
+  data.tar.gz: 8ed1bc203385cbd35f7f6d1a4b45a1ed5846723ebb70a2cad7651c56c8111ed7
 SHA512:
-  metadata.gz: 7cb275bc3fb480877c2896e6ccee09b08ced3646253e2b7e300213727596aee0cfb85b81e4b9839359c5aace091d95c46ba66211ea62176ce5eb4bb0c9266072
-  data.tar.gz: 9ef8d4268b7a0698e6fb773f1fe96ee1b0f93a264986975ff76ef50223407a15ae57a7aae7d64225b224dca4b46595a6e99f674f43ef67d6072eed1585c21422
+  metadata.gz: d791c3f1c8b0d0f53f7cb44e7cf810fd5c6854efc1b43aa852a27057cd1744845c4ca6ecd99b9ab6025b3e68c5dc75003aecad87db155521794524d16443d727
+  data.tar.gz: 3066169a2f8e2f2ff0c891976763d148d83d9f6790bb1356a9ceaad534f2ac14f39d04d98b1f9279a1ce5acd67ba668e828ab17ff0060c4dd47d523404e5d317

data/CHANGELOG.md

@@ -1,5 +1,45 @@
 # Changelog
 
+## 0.3.0 - 2026-08-26
+
+### The order description rides the prepare and create responses
+
+What the payer is BUYING, in the host's own words. When the resolver answers
+with a `description` beside the amount, the handler echoes it on
+`POST /checkouts/prepare` and on `POST /checkouts` — as a SIBLING of `checkout`,
+not a field inside it, because the `Checkout` object is shared with the swap
+responses. It is never read from a request body: the payer does not write the
+copy next to the amount. Blank and non-string values are treated as absent.
+
+Golden vectors 16 and 17 pin both responses, so the Ruby and JavaScript engines
+cannot drift on the shape.
+
+The full release narrative lives in the repository-root
+[CHANGELOG](https://github.com/openreceive/openreceive/blob/master/CHANGELOG.md).
+
+## 0.2.4 - 2026-08-26
+
+No Ruby changes in this release. 0.2.4 is browser-side only —
+`@openreceive/browser`, `@openreceive/elements`, `@openreceive/react` and
+`@openreceive/provider-data`. This gem is byte-identical to 0.2.3 and ships to
+keep the one-version-for-everything rule, so the engine, the HTTP contract and
+the settlement path are unchanged. The full release narrative lives in the
+repository-root
+[CHANGELOG](https://github.com/openreceive/openreceive/blob/master/CHANGELOG.md).
+
+## 0.2.3 - 2026-08-25
+
+The Ruby gems release in lockstep with the npm workspace version. The full
+release narrative lives in the repository-root
+[CHANGELOG](https://github.com/openreceive/openreceive/blob/master/CHANGELOG.md);
+entries here are scoped to this gem.
+
+- **`POST /checkouts` now echoes `payment_methods`** (HTTP contract 0.4.1),
+  amount-aware against the minted attempt's own invoice amount and served on
+  the re-fetch path too. `prepare` and `payments/check` already did; the mint
+  alone did not, so any client without a library-side merge lost its pay-in
+  catalog the moment it minted Lightning.
+
 ## 0.2.2 - 2026-08-25
 
 The Ruby gems release in lockstep with the npm workspace version. The full

data/lib/openreceive/server/request_handler.rb

@@ -50,7 +50,10 @@ module OpenReceive
           guard("checkout.prepare", request, { reference: reference })
           resolved = resolve_host("checkout.prepare", request, reference, body)
           prepared = @service.prepare_checkout("amount" => required_amount(resolved))
-          success(200, prepared.merge("reference" => reference), request_id)
+          body = prepared.merge("reference" => reference)
+          description = resolved_description(resolved)
+          body["description"] = description if description
+          success(200, body, request_id)
         end
       end
 
@@ -73,7 +76,17 @@ module OpenReceive
                        )
                      end
           commit(checkout, nil, request) unless resolved["payment_hash"]
-          success(201, { "checkout" => checkout }, request_id)
+          # The catalog rides along with the mint for the same reason it rides
+          # along with prepare and payments/check (mirrors the JS handler): a
+          # client that just minted Lightning must not lose the pay-in options
+          # it renders its picker from. Amount-aware, against this attempt's
+          # committed invoice amount — and served on the re-fetch path too, so
+          # a repeated create answers with the same shape it first did.
+          payment_methods = @service.list_swap_options(amount_msats: checkout["amount_msats"])
+          body = { "checkout" => checkout, "payment_methods" => payment_methods }
+          description = resolved_description(resolved)
+          body["description"] = description if description
+          success(201, body, request_id)
         end
       end
 
@@ -515,6 +528,18 @@ module OpenReceive
         memo
       end
 
+      # What the payer is buying, in the host's own words: one optional display
+      # string the host returns beside the price. Response only — it is never
+      # read from a request body, because the payer does not get to write the
+      # copy next to the amount. Blank is the same as absent.
+      def resolved_description(resolved)
+        value = resolved["description"]
+        return nil unless value.is_a?(String)
+
+        trimmed = value.strip
+        trimmed.empty? ? nil : trimmed
+      end
+
       def required_amount(resolved)
         amount = resolved["amount"]
         if amount.nil?

data/lib/openreceive/server/version.rb

@@ -2,6 +2,6 @@
 
 module OpenReceive
   module Server
-    VERSION = "0.2.2"
+    VERSION = "0.3.0"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: openreceive-server
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.3.0
 platform: ruby
 authors:
 - OpenReceive
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.2.2
+        version: 0.3.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.2.2
+        version: 0.3.0
 description: 'Server building blocks for OpenReceive: a storage-free Service that
   mirrors the Node engine and a framework-agnostic Rack app implementing the shipped
   HTTP routes while the host owns order and payment persistence. Receive-only: it