openreceive-server 0.3.1 → 0.3.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d476e033b4974c2349800f3a8aae6b3a097027b912b208dfeffd7a79e9a19b0f
-  data.tar.gz: e6a8d6732c35b93f6414d85c0aec841cc81d400c187c0d7fa50cab817a675614
+  metadata.gz: 69c84c3c9d2c89bf54eb2a69b10560be5f5b51bdadc38fed124d47a43c737bf5
+  data.tar.gz: 7bba81aa2ae40c14a41fd8ec713b3aae342f1f87e46be107668c01271dd82997
 SHA512:
-  metadata.gz: 1e86a0afe927a1d99b70f1e1b59c92f1b89622353796f5e0b8a59a5e874eb31e55aa8d2517a17e63d6cb00d167b7e0819f4a2364f10b1668660db36342a0cd55
-  data.tar.gz: 3f00557f4b1aaf1593d3f0ac39d69a35c81c318f80f9e98657d6661bd2e39bcaf047c2dc7bbf7d2d0fcb608e20524eb0bd6a593bd658adf63043197f10d7ac9c
+  metadata.gz: 7e57669e81f47d6df8941ba953cdc6791f125bbad010f2e9a3f7cd6968ddb626afeb1d6fd608bdb893573fe0981f0a7d19fe75e0739eef1594cf00cfe319a3af
+  data.tar.gz: 62b051babf8198b51de547e7c7535803f0fa658df930efea0e69205c3a3bbef733116681944758780c822a8046c185f5f9782cc80c7abf9dcbf182d5227c915e

data/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.3.2 - 2026-08-29
+
+### An overpaid swap deposit is a refund, not a support ticket
+
+`normalize_status` mapped a FixedFloat-compatible `EMERGENCY` carrying `MORE`
+to `attention`, which is terminal and has no refund form. The provider itself
+opens `refund_required` for an overpay and accepts a full `choice=REFUND`, so
+the gem now does the same: `MORE` / `OVER` / `OVERPAID` fall through to
+`refund_required`, and `refund_reason` gains `overpaid` and
+`overpaid_and_late`. The refund returns the whole deposit — the payout is a
+fixed-amount bolt11, so a surplus has nothing to convert into.
+
 ## 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

data/lib/openreceive/server/swap/fixedfloat.rb

@@ -642,12 +642,11 @@ module OpenReceive
                   "attention_reason" => "provider_reported_emergency"
                 }
               end
-              if (statuses & %w[MORE OVER OVERPAID]).any?
-                return {
-                  "state" => "attention", "attention" => true,
-                  "attention_reason" => "provider_reported_emergency"
-                }
-              end
+              # An overpay (MORE) takes the same self-serve full-refund path as
+              # LESS and EXPIRED — it is what the provider itself does with it.
+              # There is no partial refund of the surplus: the payout invoice is
+              # a fixed amount, so an emergency deposit is returned whole or not
+              # at all.
               result = { "state" => "refund_required" }
               result["refund_reason"] = refund_reason unless refund_reason.nil?
               return result
@@ -662,11 +661,17 @@ module OpenReceive
             }
           end
 
+          # LIMIT rides along with LESS/MORE when the deposit fell outside the
+          # pair's limits. It says nothing the payer can act on beyond the
+          # amount itself, so it names no reason of its own.
           def refund_reason_from_emergency_statuses(statuses)
             less = statuses.include?("LESS")
+            more = (statuses & %w[MORE OVER OVERPAID]).any?
             expired = statuses.include?("EXPIRED")
             return "underpaid_and_late" if less && expired
+            return "overpaid_and_late" if more && expired
             return "underpaid" if less
+            return "overpaid" if more
             return "late_deposit" if expired
 
             nil

data/lib/openreceive/server/version.rb

@@ -2,6 +2,6 @@
 
 module OpenReceive
   module Server
-    VERSION = "0.3.1"
+    VERSION = "0.3.2"
   end
 end

metadata

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