@clocknext/sdk 0.20.1 → 0.20.2

package/dist/index.d.cts

@@ -748,18 +748,18 @@ interface WalletLedgerPage {
     /** Reserved Wallet balance, USD; `null` when the workspace hasn't enabled
      *  it. */
     reservedBalanceUsd: number | null;
-    /** The customer's own low-balance alert level, USD; `null` when none is set.
+    /** The customer's own low-balance threshold, USD; `null` when none is set.
      *  At or below it the `wallet.balance.drop` webhook fires for this customer.
      *  Set with `customers.setWalletAlert()`. */
-    lowBalanceAlertUsd: number | null;
+    lowBalanceThresholdUsd: number | null;
     transactions: WalletTransaction[];
     /** Pass back as `cursor` for the next page; `null` on the last page. */
     nextCursor: string | null;
 }
 /** Result of `customers.setWalletAlert()`. */
 interface WalletAlert {
-    /** The saved low-balance alert level, USD; `null` once cleared. */
-    lowBalanceAlertUsd: number | null;
+    /** The saved low-balance threshold, USD; `null` once cleared. */
+    lowBalanceThresholdUsd: number | null;
 }
 interface WalletLedgerParams {
     /** Default 50, max 200. */
@@ -2523,14 +2523,19 @@ declare class Taxes {
  * dashboard (Settings → Webhooks). Two events exist today:
  *
  *   wallet.balance.update  a customer's MAIN wallet balance moved (credit or
- *                          debit). Invoice settlements and the Reserved
- *                          Wallet do not fire it.
+ *                          debit). NOT sent for changes caused by signals
+ *                          (usage debits and outcome / unit / composite
+ *                          charges): they can arrive thousands of times a
+ *                          minute. Invoice settlements and the Reserved
+ *                          Wallet do not fire it either. To read the current
+ *                          balance use `customers.balances()`.
  *   wallet.balance.drop    a debit took the balance from above a level to at
  *                          or below it. The level is the customer's own alert
  *                          level (`customers.setWalletAlert`) when they have
  *                          one, otherwise the endpoint's threshold. Fires once
  *                          per drop through the level, not on every debit while
- *                          the balance stays under it.
+ *                          the balance stays under it. A signal that crosses
+ *                          the level DOES fire it.
  *
  * Verify every request before trusting it — {@link constructWebhookEvent} does
  * that and returns the typed event. It needs the RAW request body: parsing the

package/dist/index.d.ts

@@ -748,18 +748,18 @@ interface WalletLedgerPage {
     /** Reserved Wallet balance, USD; `null` when the workspace hasn't enabled
      *  it. */
     reservedBalanceUsd: number | null;
-    /** The customer's own low-balance alert level, USD; `null` when none is set.
+    /** The customer's own low-balance threshold, USD; `null` when none is set.
      *  At or below it the `wallet.balance.drop` webhook fires for this customer.
      *  Set with `customers.setWalletAlert()`. */
-    lowBalanceAlertUsd: number | null;
+    lowBalanceThresholdUsd: number | null;
     transactions: WalletTransaction[];
     /** Pass back as `cursor` for the next page; `null` on the last page. */
     nextCursor: string | null;
 }
 /** Result of `customers.setWalletAlert()`. */
 interface WalletAlert {
-    /** The saved low-balance alert level, USD; `null` once cleared. */
-    lowBalanceAlertUsd: number | null;
+    /** The saved low-balance threshold, USD; `null` once cleared. */
+    lowBalanceThresholdUsd: number | null;
 }
 interface WalletLedgerParams {
     /** Default 50, max 200. */
@@ -2523,14 +2523,19 @@ declare class Taxes {
  * dashboard (Settings → Webhooks). Two events exist today:
  *
  *   wallet.balance.update  a customer's MAIN wallet balance moved (credit or
- *                          debit). Invoice settlements and the Reserved
- *                          Wallet do not fire it.
+ *                          debit). NOT sent for changes caused by signals
+ *                          (usage debits and outcome / unit / composite
+ *                          charges): they can arrive thousands of times a
+ *                          minute. Invoice settlements and the Reserved
+ *                          Wallet do not fire it either. To read the current
+ *                          balance use `customers.balances()`.
  *   wallet.balance.drop    a debit took the balance from above a level to at
  *                          or below it. The level is the customer's own alert
  *                          level (`customers.setWalletAlert`) when they have
  *                          one, otherwise the endpoint's threshold. Fires once
  *                          per drop through the level, not on every debit while
- *                          the balance stays under it.
+ *                          the balance stays under it. A signal that crosses
+ *                          the level DOES fire it.
  *
  * Verify every request before trusting it — {@link constructWebhookEvent} does
  * that and returns the typed event. It needs the RAW request body: parsing the

package/dist/index.js

@@ -338,7 +338,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;