@openreceive/http 0.4.12 → 0.4.13

package/dist/adapter-surface.js

@@ -7,7 +7,7 @@ import {
   isServiceErrorShape,
   mapHostRouteError,
   startNotificationWorker
-} from "./chunk-PGZAFYN6.js";
+} from "./chunk-YIN33FVH.js";
 export {
   HostError,
   HttpError,

package/dist/{chunk-PGZAFYN6.js → chunk-YIN33FVH.js}

@@ -1307,10 +1307,11 @@ function abortableDelay(milliseconds, signal) {
 }
 
 // src/reconcile-gate.ts
-var OPENRECEIVE_MIN_RECONCILE_INTERVAL_SECONDS = 2;
+var OPENRECEIVE_MIN_RECONCILE_INTERVAL_SECONDS = 3;
 var OPENRECEIVE_RECONCILE_SCAN_TIMEOUT_MS = 9e3;
+var SCAN_BACKSTOP_GRACE_MS = 500;
 var OPENRECEIVE_RECONCILE_SCAN_MAX_PAGES = 50;
-var EARLY_INVOICE_INTERVAL_SECONDS = 2;
+var EARLY_INVOICE_INTERVAL_SECONDS = 3;
 var MID_INVOICE_INTERVAL_SECONDS = 6;
 var LATE_INVOICE_INTERVAL_SECONDS = 12;
 var EARLY_INVOICE_WINDOW_SECONDS = 2 * 60;
@@ -1345,7 +1346,10 @@ async function maybeReconcilePayments(input) {
   try {
     const clock = input.clock ?? unixSeconds5;
     const now = clock();
-    const minInterval = Math.max(2, input.minIntervalSeconds ?? 2);
+    const minInterval = Math.max(
+      OPENRECEIVE_MIN_RECONCILE_INTERVAL_SECONDS,
+      input.minIntervalSeconds ?? OPENRECEIVE_MIN_RECONCILE_INTERVAL_SECONDS
+    );
     const timeout = Math.min(
       OPENRECEIVE_RECONCILE_SCAN_TIMEOUT_MS,
       input.scanTimeoutMs ?? OPENRECEIVE_RECONCILE_SCAN_TIMEOUT_MS
@@ -1370,20 +1374,19 @@ async function maybeReconcilePayments(input) {
         candidates = await input.host.payments.listReconcilableAttempts(null);
       const last = candidates.at(-1);
       scheduler.cursor = last === void 0 || candidates.length < OPENRECEIVE_RECONCILE_BATCH_SIZE ? null : { created_at: last.createdAt, payment_hash: last.paymentHash };
-      const fresh = candidates.filter((attempt) => !queued.has(attempt.paymentHash));
-      if (fresh.length > 0)
-        scheduler.windows.push(
-          createPaymentScanWindow(
-            fresh.map((attempt) => ({
-              payment_hash: attempt.paymentHash,
-              created_at: attempt.createdAt,
-              expires_at: attempt.expiresAt,
-              created_at_source: attempt.createdAtSource ?? "host"
-            })),
-            now,
-            input.overlapSeconds
-          )
+      const fresh = candidates.filter((attempt) => !queued.has(attempt.paymentHash)).map((attempt) => ({
+        payment_hash: attempt.paymentHash,
+        created_at: attempt.createdAt,
+        expires_at: attempt.expiresAt,
+        created_at_source: attempt.createdAtSource ?? "host"
+      }));
+      for (const wallet of [true, false]) {
+        const cohort = fresh.filter(
+          (attempt) => attempt.created_at_source === "wallet" === wallet
         );
+        if (cohort.length > 0 && scheduler.windows.length < 2)
+          scheduler.windows.push(createPaymentScanWindow(cohort, now, input.overlapSeconds));
+      }
     }
     const window = scheduler.windows.shift();
     if (window === void 0) {
@@ -1445,7 +1448,7 @@ async function maybeReconcilePayments(input) {
           }
         }
       }),
-      timeout,
+      timeout + SCAN_BACKSTOP_GRACE_MS,
       controller
     );
     if (slice.outcome === "continued") {

package/dist/index.d.ts

@@ -282,15 +282,16 @@ declare function startReconciler(input: {
 
 /**
  * Floor for the durable reconcile-gate interval: at most one real wallet scan
- * per two seconds across EVERY worker sharing the host database. This gate is
+ * per three seconds across EVERY worker sharing the host database. This gate is
  * the NWC rate limit for settlement scans — open tabs polling `payments/check`
  * (~3s) all share the one global pass instead of fanning out wallet walks.
  */
-declare const OPENRECEIVE_MIN_RECONCILE_INTERVAL_SECONDS: 2;
+declare const OPENRECEIVE_MIN_RECONCILE_INTERVAL_SECONDS: 3;
 /**
  * Wall-clock bound on an awaited request-path pass: a slow wallet must not
- * hang user-facing requests. A timed-out pass counts as a failed scan; the
- * gate stays claimed so the next interval retries without a stampede.
+ * hang user-facing requests. A page still in flight at the deadline is cut;
+ * the pass keeps the progress of its completed pages, and the next interval
+ * resumes there.
  */
 declare const OPENRECEIVE_RECONCILE_SCAN_TIMEOUT_MS: 9000;
 /** Page cap per wallet-history walk on the awaited request path. */
@@ -304,7 +305,7 @@ type OpportunisticReconcileResult = {
 interface MaybeReconcilePaymentsOptions {
     readonly service: OpenReceive;
     readonly host: Host;
-    /** Gate interval floor. Default (and minimum) 2 seconds. */
+    /** Gate interval floor. Default (and minimum) 3 seconds. */
     readonly minIntervalSeconds?: number;
     readonly overlapSeconds?: number;
     readonly scanTimeoutMs?: number;
@@ -315,7 +316,7 @@ interface MaybeReconcilePaymentsOptions {
 }
 /**
  * The gate interval for the current pending set: the configured floor,
- * stretched by invoice age (2s while any pending invoice is under 2 minutes
+ * stretched by invoice age (3s while any pending invoice is under 2 minutes
  * old, 6s under 5 minutes, else 12s).
  */
 declare function reconcileIntervalSeconds(attempts: readonly ReconcilableAttempt[], now: number, minIntervalSeconds?: number): number;

package/dist/index.js

@@ -34,7 +34,7 @@ import {
   startReconciler,
   typeOrmDb,
   webRequest
-} from "./chunk-PGZAFYN6.js";
+} from "./chunk-YIN33FVH.js";
 export {
   HostError,
   HttpError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openreceive/http",
-  "version": "0.4.12",
+  "version": "0.4.13",
   "description": "Node.js HTTP routes and payment storage for Bitcoin Lightning checkout, with optional USDT, USDC, SOL and ETH swaps.",
   "keywords": [
     "bitcoin",
@@ -17,8 +17,8 @@
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "dependencies": {
-    "@openreceive/core": "0.4.12",
-    "@openreceive/node": "0.4.12"
+    "@openreceive/core": "0.4.13",
+    "@openreceive/node": "0.4.13"
   },
   "exports": {
     ".": {

package/skills/debug-openreceive-payment/SKILL.md

@@ -49,7 +49,7 @@ same diagnostics redacted, always exit 0 — safe to share.
 ## 4. Paid but never settles
 
 - Settlement is opportunistic: any OpenReceive request runs one reconcile pass
-  through a durable gate (min 2s between wallet scans, stretched by invoice
+  through a durable gate (min 3s between wallet scans, stretched by invoice
   age). A quiet server settles on the next request — or run the optional
   notification worker. No timer is missing; that is the design.
 - An unpaid attempt closes only after a successful wallet scan at/after expiry

package/skills/integrate-openreceive/references/btcpay.md

@@ -1,6 +1,6 @@
 # OpenReceive agent directions (BTCPay Server)
 
-These directions describe OpenReceive 0.4.12.
+These directions describe OpenReceive 0.4.13.
 
 Connect a BTCPay Server store to a receive-only NWC wallet with the OpenReceive
 plugin, and optionally let payers pay BTCPay invoices with USDT, USDC, ETH or

package/skills/integrate-openreceive/references/django.md

@@ -1,6 +1,6 @@
 # OpenReceive agent directions (Django)
 
-These directions describe OpenReceive 0.4.12.
+These directions describe OpenReceive 0.4.13.
 
 Add OpenReceive to a Django project — the app you are already working in. You
 do not need a copy of the OpenReceive source: the Python package is on PyPI

package/skills/integrate-openreceive/references/fastapi.md

@@ -1,6 +1,6 @@
 # OpenReceive agent directions (FastAPI)
 
-These directions describe OpenReceive 0.4.12.
+These directions describe OpenReceive 0.4.13.
 
 Add OpenReceive to a FastAPI application — the app you are already working in.
 You do not need a copy of the OpenReceive source: the engine is on PyPI

package/skills/integrate-openreceive/references/fastify.md

@@ -1,6 +1,6 @@
 # OpenReceive agent directions (Fastify)
 
-These directions describe OpenReceive 0.4.12.
+These directions describe OpenReceive 0.4.13.
 
 Add OpenReceive to a Fastify application — the app you are already working in.
 You do not need a copy of the OpenReceive source: the packages are on npm, and

package/skills/integrate-openreceive/references/laravel.md

@@ -1,6 +1,6 @@
 # OpenReceive agent directions (Laravel)
 
-These directions describe OpenReceive 0.4.12.
+These directions describe OpenReceive 0.4.13.
 
 Add OpenReceive to a Laravel application — the app you are already working in.
 You do not need a copy of the OpenReceive source: the package is on Packagist

package/skills/integrate-openreceive/references/next.md

@@ -1,6 +1,6 @@
 # OpenReceive agent directions (Next.js)
 
-These directions describe OpenReceive 0.4.12.
+These directions describe OpenReceive 0.4.13.
 
 Add OpenReceive to a Next.js App Router application — the app you are already
 working in. You do not need a copy of the OpenReceive source: the packages are

package/skills/integrate-openreceive/references/node.md

@@ -1,6 +1,6 @@
 # OpenReceive agent directions (Node.js)
 
-These directions describe OpenReceive 0.4.12.
+These directions describe OpenReceive 0.4.13.
 
 Add OpenReceive to a Node application — the app you are already working in. You
 do not need a copy of the OpenReceive source: the packages are on npm, and the

package/skills/integrate-openreceive/references/php.md

@@ -1,6 +1,6 @@
 # OpenReceive agent directions (PHP)
 
-These directions describe OpenReceive 0.4.12.
+These directions describe OpenReceive 0.4.13.
 
 Add OpenReceive to a PHP application — the app you are already working in. You
 do not need a copy of the OpenReceive source: the engine is on Packagist
@@ -651,7 +651,7 @@ use registry `icon_path` / tutorial `path` keys as browser URLs.
 
 Settlement runs on the request path. Every payment route first runs one bounded
 reconcile pass through the durable `openreceive_meta` gate. The gate allows at
-most one real wallet scan every 2 seconds, shared by every PHP process. You do
+most one real wallet scan every 3 seconds, shared by every PHP process. You do
 not need a cron job. Tune or disable it with `Engine`'s
 `opportunisticReconcile` (`false`, or `['min_interval_seconds' => …]`).
 

package/skills/integrate-openreceive/references/rails.md

@@ -1,6 +1,6 @@
 # OpenReceive agent directions (Rails)
 
-These directions describe OpenReceive 0.4.12.
+These directions describe OpenReceive 0.4.13.
 
 Add OpenReceive to a Rails application — the app you are already working in. You
 do not need a copy of the OpenReceive source: the gem is on RubyGems, the

package/skills/integrate-openreceive/references/woocommerce.md

@@ -1,6 +1,6 @@
 # OpenReceive agent directions (WordPress + WooCommerce)
 
-These directions describe OpenReceive 0.4.12.
+These directions describe OpenReceive 0.4.13.
 
 Install and configure the OpenReceive gateway in the existing WooCommerce
 store. Preserve its theme, checkout, customer accounts, order model and prices.