@unicitylabs/sphere-sdk 0.14.11-dev.7 → 0.14.11

package/dist/modules/payments-v2/index.cjs

@@ -39,10 +39,16 @@ __export(payments_v2_exports, {
   PaymentsFacade: () => PaymentsFacade,
   STORE_KEYS: () => STORE_KEYS,
   createScopedKV: () => createScopedKV,
+  isRetryableAckError: () => isRetryableAckError,
   supportsDeterministicMint: () => supportsDeterministicMint
 });
 module.exports = __toCommonJS(payments_v2_exports);
 
+// modules/payments-v2/ports.ts
+function isRetryableAckError(err) {
+  return err !== null && typeof err === "object" && err.retryable === true;
+}
+
 // modules/payments-v2/stores.ts
 function createScopedKV(storage, network, chainPubkey) {
   const prefix = `pv2:${network}:${chainPubkey}:`;
@@ -581,12 +587,19 @@ var SerialChain = class {
     return run;
   }
 };
-function coalesced(run) {
+function coalesced(run, observe) {
   let inFlight = false;
   let queued = false;
   const start = () => {
     inFlight = true;
-    void run().catch(() => void 0).finally(() => {
+    let running;
+    try {
+      running = run();
+    } catch {
+      running = Promise.resolve();
+    }
+    observe?.(running);
+    void running.catch(() => void 0).finally(() => {
       inFlight = false;
       if (!queued) return;
       queued = false;
@@ -3232,11 +3245,6 @@ var logger = {
   }
 };
 
-// modules/payments-v2/ports.ts
-function isRetryableAckError(err) {
-  return err !== null && typeof err === "object" && err.retryable === true;
-}
-
 // modules/payments-v2/receive/Receive.ts
 var ACK_BATCH_SIZE = 200;
 var REFRESH_INTERVAL_MS = 2500;
@@ -3285,13 +3293,26 @@ var Receive = class {
    * the tokens just accepted, and the balance would still only move at the end.
    * Ordering is preserved: store() still precedes the ack (§5.7).
    */
-  async maybeRefresh(deps, pending, epochOf) {
+  async maybeRefresh(ctx) {
+    const { deps, pending, pageEpoch } = ctx;
     if (deps.refreshView === void 0) return;
     const now = deps.now?.() ?? Date.now();
     if (now - this.lastRefreshAt < REFRESH_INTERVAL_MS) return;
     this.lastRefreshAt = now;
-    await flushAcks(deps, pending, epochOf);
-    deps.refreshView();
+    if ((await flushAcks(deps, pending, pageEpoch)).progressed) deps.refreshView();
+  }
+  /** One listing pass: process each entry, flushing and refreshing as it goes. */
+  async drainPages(ctx, basis) {
+    const { deps, pending, pageEpoch, claimable } = ctx;
+    for await (const entry of deps.delivery.incoming(basis === null ? void 0 : String(basis.cursor))) {
+      const claimableBefore = claimable.n;
+      await this.processEntry(ctx, entry);
+      if (pending.length >= ACK_BATCH_SIZE) {
+        if (!(await flushAcks(deps, pending, pageEpoch)).progressed) return;
+      }
+      if (claimable.n > claimableBefore) await this.maybeRefresh(ctx);
+    }
+    await flushAcks(deps, pending, pageEpoch);
   }
   async doDrain() {
     const deps = this.deps;
@@ -3300,17 +3321,16 @@ var Receive = class {
     const stored = [];
     const pending = [];
     const pageEpoch = () => deps.delivery.incomingEpoch() ?? deps.syncEpoch();
+    const claimable = { n: 0 };
+    const finish = () => {
+      if (claimable.n > 0) deps.refreshView?.();
+      return stored;
+    };
     try {
       const record = await deps.kv.get(STORE_KEYS.streamCursor("mailbox"));
       let basis = record !== null && record.syncEpoch === deps.syncEpoch() ? record : null;
       for (let pass = 0; pass < 2; pass++) {
-        for await (const entry of deps.delivery.incoming(basis === null ? void 0 : String(basis.cursor))) {
-          const storedBefore = stored.length;
-          await this.processEntry(deps, engine, entry, pending, stored);
-          if (pending.length >= ACK_BATCH_SIZE) await flushAcks(deps, pending, pageEpoch);
-          if (stored.length > storedBefore) await this.maybeRefresh(deps, pending, pageEpoch);
-        }
-        await flushAcks(deps, pending, pageEpoch);
+        await this.drainPages({ deps, engine, pending, stored, pageEpoch, claimable }, basis);
         const served = deps.delivery.incomingEpoch();
         if (basis === null || served === null || served === basis.syncEpoch) break;
         await deps.kv.remove(STORE_KEYS.streamCursor("mailbox"));
@@ -3318,21 +3338,25 @@ var Receive = class {
       }
     } catch (err) {
       logger.warn("PaymentsV2", "receive drain interrupted \u2014 unacked entries retry next drain:", err);
-      if (isRetryableAckError(err)) return stored;
+      if (isRetryableAckError(err)) return finish();
       await flushAcks(deps, pending, pageEpoch).catch((flushErr) => {
         logger.warn("PaymentsV2", "receive ack flush failed \u2014 cursor holds at the acked prefix:", flushErr);
+        return { progressed: false };
       });
     }
-    return stored;
+    return finish();
   }
-  async processEntry(deps, engine, entry, pending, stored) {
+  async processEntry(ctx, entry) {
+    const { deps, engine, pending, stored, claimable } = ctx;
     const screened = await screen(deps, engine, entry);
     if (screened.kind === "ack") {
       pending.push(screened.ack);
+      if (screened.ack.disposition === "claimed") claimable.n += 1;
       return;
     }
     await deps.view.store(screened.record);
     pending.push(claimAck(entry));
+    claimable.n += 1;
     const transfer = await announce(deps, entry, screened.record);
     stored.push(transfer);
     deps.emit("transfer:incoming", transfer);
@@ -3393,7 +3417,8 @@ async function announce(deps, entry, record) {
   };
 }
 async function flushAcks(deps, pending, epochOf) {
-  if (pending.length === 0) return;
+  if (pending.length === 0) return { progressed: true };
+  const before = pending.length;
   let lastAcked = null;
   try {
     const settled = await settleAcks(deps, pending);
@@ -3411,6 +3436,7 @@ async function flushAcks(deps, pending, epochOf) {
       await deps.kv.set(STORE_KEYS.streamCursor("mailbox"), record);
     }
   }
+  return { progressed: pending.length < before };
 }
 async function settleAcks(deps, pending) {
   const batch = deps.delivery.ackBatch?.bind(deps.delivery);
@@ -4253,7 +4279,7 @@ function composeFacadeParts(deps, hooks) {
   const machineDeps = buildMachineDeps(deps, hooks, historyStore);
   const machineStores = createMachineStores(deps.kv);
   const heldStates = /* @__PURE__ */ new Map();
-  const refreshView = coalesced(() => view.delta());
+  const refreshView = coalesced(() => view.delta(), hooks.track);
   return {
     ownPubkeyBytes,
     view,
@@ -4396,7 +4422,8 @@ var PaymentsFacade = class {
     const parts = composeFacadeParts(deps, {
       engine: () => this.engine(),
       send: (request) => this.send(request),
-      isActiveOp: (id) => this.activeMoneyOps.has(id)
+      isActiveOp: (id) => this.activeMoneyOps.has(id),
+      track: (op) => this.trackTail(op)
     });
     this.view = parts.view;
     this.wakeRefresh = parts.refreshView;
@@ -4536,7 +4563,6 @@ var PaymentsFacade = class {
   }
   async receive() {
     const transfers = await this.track(this.receiveLoop.drainOnce());
-    if (transfers.length > 0) this.trackTail(this.view.delta());
     return { transfers };
   }
   mint(coinId, amount) {
@@ -5014,6 +5040,7 @@ var PaymentsFacade = class {
   PaymentsFacade,
   STORE_KEYS,
   createScopedKV,
+  isRetryableAckError,
   supportsDeterministicMint
 });
 /*! Bundled license information: