usage_credits 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 36ed774a5aebbe0638ebdfc33bf28aa93e8c59bc9da80767e7f4f1598ee1dd96
-  data.tar.gz: 5e44018f29eba1d7a99c4f46f969c09fff2d86441ce6024630f3f0756357d677
+  metadata.gz: 710aa384672853be7b8711cffb537ad348761d0f8bf8c9df899565c7917522a8
+  data.tar.gz: de219e55c5442ce44bbdf9bc1843c5bdeaa1e32508e3ee3c193f5baef0b7c259
 SHA512:
-  metadata.gz: 6075093fad2de5a3ece80406537e76b09f094bd80f9805df0c43b5ef402764d0ef2d92ffddb342ae2ccfa87bf6e4f79f80ae1a5ad8009c9d66cc62e2061a055c
-  data.tar.gz: 4fe597e7027e3495cc3ba3bce7c15bd77ec95403d6735ebba9fc03ca4ba4ee280247c6866e8a005508a6e8231b29af77d2309dd3e2cd1ca1bc94f419065dacd4
+  metadata.gz: ddd7d4f68a78f5608ded3984b277b6956ed1f849a72061a1816e1456252a164d87b771dd94337d653f28414932e349d31c88168085c1ead78e4083103920f356
+  data.tar.gz: cfaa71674966f0197675a0467cce70d5476b4dd161d838907567e286920590a3051463cb1583baab92e23e852942b6414812df23ed93dc2a421f613f9c853b8f

data/CHANGELOG.md

@@ -1,3 +1,10 @@
+## [1.0.1] - 2026-10-18
+
+### Fixed
+
+- **A refused `spend_credits_on` no longer poisons the wallet instance.** When the block had spent on the same wallet instance (or a caller's transaction rolled a command back), Rails left the cached balance and `ledger_revision` the command had written in memory as unsaved changes, and the next command on that instance raised `RuntimeError: Locking a record with unpersisted changes is not supported` instead of running. The fix is in `wallets` 0.4.2, which this release requires (`~> 0.4.2`); a regression test here pins the `spend_credits_on` shape.
+- `InsufficientCredits` speaks of credits whichever command raised it: `deduct_credits` and transfers used to pass the core's "Insufficient balance (5 < 10)" through, while `spend_credits_on` said "Insufficient credits (5 < 10)".
+
 ## [1.0.0] - 2026-10-18
 
 `usage_credits` is now built on top of [`wallets`](https://github.com/rameerez/wallets), our append-oriented, multi-asset ledger core. The credits-focused DX you know is unchanged — same `has_credits`, `spend_credits_on`, `give_credits`, packs, subscriptions, and Pay integration — but the expiration-aware allocation ledger, balance math, row-level locking, and transfer machinery now live in a shared, independently tested core.

data/README.md

@@ -22,7 +22,7 @@ All with a simple DSL that reads just like English.
 - Ruby 3.2+ and Rails 7.2.3.1–8.x. Ruby 3.2 is the security floor because current patched versions of transitive Rails dependencies no longer support Ruby 3.1.
 - An ActiveJob backend (Sidekiq, `solid_queue`, etc.) for subscription credit fulfillment
 - [`pay`](https://github.com/pay-rails/pay) 11.6.2–11.x for payment integration. Pay 11.6.2 is the security floor because it fixes [GHSA-mjgf-xj26-9qf9](https://github.com/pay-rails/pay/security/advisories/GHSA-mjgf-xj26-9qf9).
-- [`wallets`](https://github.com/rameerez/wallets) 0.4.x (installed automatically as the ledger core)
+- [`wallets`](https://github.com/rameerez/wallets) 0.4.2 or any later 0.4.x (installed automatically as the ledger core)
 
 ## 👨‍💻 Example
 

data/lib/usage_credits/models/wallet.rb

@@ -208,7 +208,7 @@ module UsageCredits
     def deduct_credits(amount, metadata: {}, category: :credit_deducted, fulfillment: nil)
       debit(amount, metadata: metadata, category: category, fulfillment: fulfillment)
     rescue Wallets::InsufficientBalance => e
-      raise InsufficientCredits, e.message
+      raise InsufficientCredits, in_credits_terms(e.message)
     end
 
     # Shorten the lifetime of credits minted by one fulfillment and reconcile
@@ -260,7 +260,7 @@ module UsageCredits
     rescue Wallets::InvalidTransfer => e
       raise InvalidTransfer, e.message
     rescue Wallets::InsufficientBalance => e
-      raise InsufficientCredits, e.message
+      raise InsufficientCredits, in_credits_terms(e.message)
     rescue Wallets::Error => e
       raise UsageCredits::Error, e.message
     end
@@ -304,6 +304,13 @@ module UsageCredits
 
     private
 
+    # The wallets core refuses in its own words ("Insufficient balance (5 <
+    # 10)"); a credits wallet refuses in the words its own `InsufficientCredits`
+    # already uses, whichever command raised it.
+    def in_credits_terms(message)
+      message.sub(/\AInsufficient balance\b/, "Insufficient credits")
+    end
+
     # =========================================
     # Helper Methods
     # =========================================

data/lib/usage_credits/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module UsageCredits
-  VERSION = "1.0.0"
+  VERSION = "1.0.1"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: usage_credits
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - rameerez
@@ -55,14 +55,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: 0.4.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.4.0
+        version: 0.4.2
 description: Add a usage-based credit system to your Rails app, easily. Let users
   buy and spend credits on usage-based actions. Refill Stripe subscriptions with credits,
   sell one-time booster credit packs, implement PAYG (pay-as-you-go) billing, award