@pafi-dev/issuer 0.1.0 → 0.1.2

package/dist/index.d.cts

@@ -927,6 +927,25 @@ interface ApiUserRequest {
 interface ApiUserResponse {
     mintRequestNonce: bigint;
     receiverConsentNonce: bigint;
+    /**
+     * Off-chain point balance from the issuer's ledger (excludes PENDING locks).
+     * This is what the user can claim into on-chain PT via `/claim`.
+     */
+    offChainBalance: bigint;
+    /**
+     * On-chain ERC-20 balance from `PointToken.balanceOf(user)`.
+     * Points the user has already claimed but hasn't swapped or redeemed.
+     */
+    onChainBalance: bigint;
+    /**
+     * Sum of off-chain + on-chain balance. FE renders this as a single
+     * "your points" number, per the unified-balance UX spec.
+     */
+    totalBalance: bigint;
+    /**
+     * @deprecated use `offChainBalance` instead. Kept for backward compatibility
+     * — will be removed in 0.2.0.
+     */
     balance: bigint;
     isMinter: boolean;
 }

package/dist/index.d.ts

@@ -927,6 +927,25 @@ interface ApiUserRequest {
 interface ApiUserResponse {
     mintRequestNonce: bigint;
     receiverConsentNonce: bigint;
+    /**
+     * Off-chain point balance from the issuer's ledger (excludes PENDING locks).
+     * This is what the user can claim into on-chain PT via `/claim`.
+     */
+    offChainBalance: bigint;
+    /**
+     * On-chain ERC-20 balance from `PointToken.balanceOf(user)`.
+     * Points the user has already claimed but hasn't swapped or redeemed.
+     */
+    onChainBalance: bigint;
+    /**
+     * Sum of off-chain + on-chain balance. FE renders this as a single
+     * "your points" number, per the unified-balance UX spec.
+     */
+    totalBalance: bigint;
+    /**
+     * @deprecated use `offChainBalance` instead. Kept for backward compatibility
+     * — will be removed in 0.2.0.
+     */
     balance: bigint;
     isMinter: boolean;
 }

package/dist/index.js

@@ -1158,6 +1158,7 @@ function pickMatchingLock(locks, amount) {
 import { getAddress as getAddress5 } from "viem";
 import {
   getMintRequestNonce,
+  getPointTokenBalance,
   getReceiverConsentNonce,
   getTokenName,
   isMinter,
@@ -1280,16 +1281,21 @@ var IssuerApiHandlers = class {
         `handleUser: unsupported pointToken ${pointToken}`
       );
     }
-    const [mintRequestNonce, receiverConsentNonce, balance, minter] = await Promise.all([
+    const [mintRequestNonce, receiverConsentNonce, offChainBalance, onChainBalance, minter] = await Promise.all([
       getMintRequestNonce(this.provider, pointToken, normalizedAuthed),
       getReceiverConsentNonce(this.provider, pointToken, normalizedAuthed),
       this.ledger.getBalance(normalizedAuthed),
+      getPointTokenBalance(this.provider, pointToken, normalizedAuthed),
       isMinter(this.provider, pointToken, normalizedAuthed)
     ]);
     return {
       mintRequestNonce,
       receiverConsentNonce,
-      balance,
+      offChainBalance,
+      onChainBalance,
+      totalBalance: offChainBalance + onChainBalance,
+      balance: offChainBalance,
+      // deprecated alias
       isMinter: minter
     };
   }