paymos 1.5.1 → 1.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '085824f8d197938805072bbe261b174157877f18edaff7602221a68ad1bbca52'
-  data.tar.gz: 60d04d4f82f6baee7aa3b23953eb603213304f5022a87ab5a5ad8d04b5d507c4
+  metadata.gz: 5e0c80046042c2f9d6412a4634125c0a4394e9aab174d20d6b6a26fe60517e76
+  data.tar.gz: 52280f1bd972bf101b857e697addf3d1c115c09e87ae2287fdfc506c83606e09
 SHA512:
-  metadata.gz: 0f05fdb1aed2a83d2f9fdbac11ecd905eb8e013d3a2d84ffbfad02bff215412528fa8c2a3cd197492d6443d46e25b7d4389b362a3b6f00bfb504daf4a011d3de
-  data.tar.gz: e7147f721cbb9d0c7230d9bdcb785e809d67d497a6da3d663e67e81b9325d6d7abd6b6ecc71046379f6e2a0fa0fb1df2840db9249dcd700e5a15f3185bddc247
+  metadata.gz: 2a205a28f143426bbbedcafe4240751448d4161d60d7f30650570567a4e5eebf7232a4c0e313ad88853bcaa7e49a4170ddfafe3f0f4ad7e41d6946882e052531
+  data.tar.gz: ce658911f58df1d6b5f30bdb4f9c4c5894118019e57604b94d29ea759f3b9e2e568ddf0265b818eb33c91e1da05d0cd848fca5afe1e545c27ce3172767c3271d

data/CHANGELOG.md

@@ -2,6 +2,23 @@
 
 ## [Unreleased]
 
+## [1.6.0] - 2026-11-03
+
+- fix(sdk): resolve preflight lint and conformance vector count for autorelease
+- feat(refunds): finalize clean merchant refunds spec, SDKs, CMS plugins, and targeted test scripts
+
+- **403 is no longer reported as an authentication failure.** `Paymos::PermissionError` (subclasses `Paymos::AuthenticationError`, so existing `rescue` blocks keep working) now carries every 403.
+- **Base URL must use HTTPS.** Plain HTTP is accepted only against a loopback host, which is what a local integration test points at. The API secret signs every request, so a plaintext base URL put that credential on the wire.
+
+## [1.5.2] - 2026-11-02
+
+- wip: snapshot shared working tree before merging main
+- fix(merge): keep both sides for 126 conflicting files (union / semantic JSON merge); Balance.razor keeps ClickToCopy ID column
+- wip(refunds): merchant refund plugin work (CMS adapters, PHP SDK, tests) - unverified WIP snapshot
+
+- **403 is no longer reported as an authentication failure.** `Paymos::PermissionError` (subclasses `Paymos::AuthenticationError`, so existing `rescue` blocks keep working) now carries every 403.
+- **Base URL must use HTTPS.** Plain HTTP is accepted only against a loopback host, which is what a local integration test points at. The API secret signs every request, so a plaintext base URL put that credential on the wire.
+
 ## [1.5.1] - 2026-11-01
 
 - refactor(invoices): remove the multiple-payment toggle

data/README.md

@@ -67,6 +67,7 @@ outcome. Creation returns 201 and an identical replay returns 200; both yield a
 `Paymos::NotFoundError` (404). List periods use RFC 3339 timestamps, and
 `paymos.refunds.each` provides the same bounded cursor iteration as invoices.
 In sandbox, use `paymos.withdrawals.simulate_completion(refund.withdrawal_id)`,
+In sandbox, use `paymos.refunds.simulate(refund.withdrawal_id, status: 'completed')`,
 then read the refund again. Refunds have their own list and do not appear in the
 ordinary withdrawals list.
 

data/lib/paymos/client.rb

@@ -298,6 +298,22 @@ module Paymos
   end
 
   class Refunds < Resource
+    UNSPECIFIED_STATUS = Object.new.freeze
+    private_constant :UNSPECIFIED_STATUS
+
+    def simulate(refund_id, positional_status = UNSPECIFIED_STATUS, status: UNSPECIFIED_STATUS)
+      if positional_status.equal?(UNSPECIFIED_STATUS) == status.equal?(UNSPECIFIED_STATUS)
+        raise ArgumentError, 'Provide exactly one refund simulation status'
+      end
+
+      status = positional_status unless positional_status.equal?(UNSPECIFIED_STATUS)
+      unless %w[completed failed cancelled].include?(status)
+        raise ArgumentError, 'A terminal refund simulation status is required'
+      end
+
+      Refund.from(@client.request('POST', "/v1/sandbox/refunds/#{segment(refund_id)}/simulate", payload: { status: }))
+    end
+
     def create(invoice_id:, mode:, external_order_id:)
       values = { invoice_id:, mode:, external_order_id: }
       missing = values.select { |_name, value| !value.is_a?(String) || value.strip.empty? }.keys
@@ -307,11 +323,6 @@ module Paymos
       Refund.from(@client.request('POST', '/v1/refunds', payload: values))
     end
 
-    def simulate(refund_id, status)
-      Refund.from(@client.request('POST', "/v1/sandbox/refunds/#{segment(refund_id)}/simulate",
-                                  payload: { status: }))
-    end
-
     def get(refund_id) = Refund.from(@client.request('GET', "/v1/refunds/#{segment(refund_id)}"))
 
     def list(limit: nil, cursor: nil, invoice_id: nil, status: nil, created_from: nil, created_to: nil)

data/lib/paymos/models.rb

@@ -133,9 +133,9 @@ module Paymos
   end
 
   class Refund < Model
-    fields :withdrawal_id, :invoice_id, :mode, :external_order_id, :status, :is_final, :is_test,
+    fields :type, :project_id, :withdrawal_id, :invoice_id, :mode, :external_order_id, :status, :is_final, :is_test,
            :amount, :fee, :currency, :network, :destination_address, :first_sender, :tx_hash,
-           :explorer_url, :created_at, :completed_at, :failed_at, :cancelled_at, :type, :project_id,
+           :explorer_url, :created_at, :completed_at, :failed_at, :cancelled_at,
            required: %i[withdrawal_id invoice_id mode external_order_id status is_final is_test amount
                         currency network destination_address first_sender created_at]
   end

data/lib/paymos/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Paymos
-  VERSION = '1.5.1'
+  VERSION = '1.6.0'
 end

data/sig/paymos.rbs

@@ -276,6 +276,7 @@ module Paymos
 
   class Refunds
     def simulate: (String refund_id, String status) -> Refund
+                | (String refund_id, status: String) -> Refund
     def create: (invoice_id: String, mode: "full" | "overpayment", external_order_id: String) -> Refund
     def get: (String refund_id) -> Refund
     def list: (?limit: Integer?, ?cursor: String?, ?invoice_id: String?, ?status: String | Array[String]?, ?created_from: String?, ?created_to: String?) -> Page[Refund]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: paymos
 version: !ruby/object:Gem::Version
-  version: 1.5.1
+  version: 1.6.0
 platform: ruby
 authors:
 - Paymos Labs