@clocknext/sdk 0.20.1 → 0.20.2

package/README.md

@@ -888,8 +888,8 @@ and types these events; it does not create or list endpoints.)
 
 | Event | Fires when |
 | --- | --- |
-| `wallet.balance.update` | A customer's **main** wallet balance moves, credit or debit. Not for invoice settlements, and not for the Reserved Wallet. |
-| `wallet.balance.drop` | A debit takes the balance from above a level to at or below it. Fires **once per drop** through the level, not on every debit while the balance stays under it. |
+| `wallet.balance.update` | A customer's **main** wallet balance moves, credit or debit — a top-up, an adjustment, a dashboard change. **Not** for changes caused by signals (usage debits and outcome, unit and composite charges: they can arrive thousands of times a minute), not for invoice settlements, and not for the Reserved Wallet. To read the current balance use `customers.balances()`. |
+| `wallet.balance.drop` | A debit takes the balance from above a level to at or below it. Fires **once per drop** through the level, not on every debit while the balance stays under it. A signal that crosses the level **does** fire it. |
 
 The level for `wallet.balance.drop` is the customer's own alert level if they
 have one, otherwise the endpoint's threshold. Set or clear a customer's own
@@ -900,7 +900,7 @@ await cnk.customers.setWalletAlert(customerId, 50);   // alert at or below $50
 await cnk.customers.setWalletAlert(customerId, null); // clear it: fall back to each endpoint's threshold
 await cnk.customers.setWalletAlertByExternalId("acme-42", 50);
 
-(await cnk.customers.wallet(customerId)).lowBalanceAlertUsd; // 50, or null
+(await cnk.customers.wallet(customerId)).lowBalanceThresholdUsd; // 50, or null
 ```
 
 ### Verify, then handle

package/dist/index.cjs

@@ -340,7 +340,7 @@ function sleep(ms) {
 }
 
 // src/http.ts
-var SDK_VERSION = "0.20.1" ;
+var SDK_VERSION = "0.20.2" ;
 var Transport = class {
   constructor(cfg) {
     this.cfg = cfg;