@happyvertical/smrt-subscriptions 0.51.28 → 0.51.30

package/AGENTS.md

@@ -89,7 +89,10 @@ that reverted to DECIMAL passes every SQLite suite.
   cross-tenant read in evaluation is the bounded `wholesale`-basis sum.
 - `balance` policies take their limit from `CreditGrant`s; `limitAmount` must
   be 0, and currency and period are fixed once saved (the ledger is scoped to
-  them). Auto top-up is a host hook only — no payment provider calls.
+  them). Auto top-up is a host hook only — no payment provider calls. The
+  evaluator re-reads credit after the hook returns (grant or not) and hands
+  it `currentShortfall()`, so a hook that charges asynchronously can see a
+  concurrent top-up (smrt-commerce's `autoTopUpHook()`, #3139).
 
 ## Notes
 

package/README.md

@@ -110,7 +110,11 @@ Parentage and the billing owner come from `smrt-tenancy`'s
   and idempotent per `source`/`sourceId`. Pass `autoTopUp` to
   `SpendingPolicyEvaluator.create()` to be called when a charge would exhaust a
   balance; return a grant once the host has secured the funds. The evaluator
-  never calls a payment provider.
+  never calls a payment provider. Before charging, a hook can call the
+  request's `currentShortfall()` to recompute the shortfall against the
+  current balance (another evaluation may have topped it up meanwhile); the
+  evaluator re-reads the balance after the hook returns either way.
+  smrt-commerce's `BillingRuntime.autoTopUpHook()` charges a saved card.
 
 ```ts
 import { BillingRelationshipService } from '@happyvertical/smrt-tenancy';