openreceive-server 0.2.3 → 0.3.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6787423e982a56751f291210d207d6ff4c0ccd49eb438f087cc749e35b9eaae6
-  data.tar.gz: 73d06359d629e52245de41c2e6fca1068765572325bc9250acd61499904c13e1
+  metadata.gz: 709f10b4ec4f14ebd43b63977d10ea992365c3329e81b5eb1ebe02b004dce2db
+  data.tar.gz: 8ed1bc203385cbd35f7f6d1a4b45a1ed5846723ebb70a2cad7651c56c8111ed7
 SHA512:
-  metadata.gz: aa11b53030d9c8c91ab02f39ebd25c57709c540ce351b2a09dc864260d7868bda54f38f99229c374d910e6624eb4d53fb007bdfc91bd364427b15c51513c3dfd
-  data.tar.gz: c88b8c1e9576e841b8be7013e78592c25821a76ae97a2fc145f7b8adc555571b1e1b63b5f1d8b3c8d8cfad7869d44a75faf2720834c74a3badbcc3406d85db33
+  metadata.gz: d791c3f1c8b0d0f53f7cb44e7cf810fd5c6854efc1b43aa852a27057cd1744845c4ca6ecd99b9ab6025b3e68c5dc75003aecad87db155521794524d16443d727
+  data.tar.gz: 3066169a2f8e2f2ff0c891976763d148d83d9f6790bb1356a9ceaad534f2ac14f39d04d98b1f9279a1ce5acd67ba668e828ab17ff0060c4dd47d523404e5d317

data/CHANGELOG.md

@@ -1,5 +1,32 @@
 # 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

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.0"
   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.0
 platform: ruby
 authors:
 - OpenReceive
@@ -15,14 +15,14 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.2.3
+        version: 0.3.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.2.3
+        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