openreceive-server 0.2.3 → 0.3.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6787423e982a56751f291210d207d6ff4c0ccd49eb438f087cc749e35b9eaae6
-  data.tar.gz: 73d06359d629e52245de41c2e6fca1068765572325bc9250acd61499904c13e1
+  metadata.gz: d476e033b4974c2349800f3a8aae6b3a097027b912b208dfeffd7a79e9a19b0f
+  data.tar.gz: e6a8d6732c35b93f6414d85c0aec841cc81d400c187c0d7fa50cab817a675614
 SHA512:
-  metadata.gz: aa11b53030d9c8c91ab02f39ebd25c57709c540ce351b2a09dc864260d7868bda54f38f99229c374d910e6624eb4d53fb007bdfc91bd364427b15c51513c3dfd
-  data.tar.gz: c88b8c1e9576e841b8be7013e78592c25821a76ae97a2fc145f7b8adc555571b1e1b63b5f1d8b3c8d8cfad7869d44a75faf2720834c74a3badbcc3406d85db33
+  metadata.gz: 1e86a0afe927a1d99b70f1e1b59c92f1b89622353796f5e0b8a59a5e874eb31e55aa8d2517a17e63d6cb00d167b7e0819f4a2364f10b1668660db36342a0cd55
+  data.tar.gz: 3f00557f4b1aaf1593d3f0ac39d69a35c81c318f80f9e98657d6661bd2e39bcaf047c2dc7bbf7d2d0fcb608e20524eb0bd6a593bd658adf63043197f10d7ac9c

data/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## 0.3.1 - 2026-08-28
+
+No changes to this gem in 0.3.1. It is byte-identical to 0.3.0 and ships to keep
+the one-version-for-everything rule. The Ruby half of this release is in
+`openreceive-rails`. The full release narrative lives in the repository-root
+[CHANGELOG](https://github.com/openreceive/openreceive/blob/master/CHANGELOG.md).
+
+## 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

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
 
@@ -80,7 +83,10 @@ module OpenReceive
           # 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"])
-          success(201, { "checkout" => checkout, "payment_methods" => payment_methods }, request_id)
+          body = { "checkout" => checkout, "payment_methods" => payment_methods }
+          description = resolved_description(resolved)
+          body["description"] = description if description
+          success(201, body, request_id)
         end
       end
 
@@ -522,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.3"
+    VERSION = "0.3.1"
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: openreceive-server
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.3.1
 platform: ruby
 authors:
 - OpenReceive
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.2.3
+        version: 0.3.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.2.3
+        version: 0.3.1
 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