scrapely 1.2.22 → 1.2.23

package/dist/charging.d.ts

@@ -86,6 +86,19 @@ export declare class ChargingManager {
      * Actors never go positive, so they get nothing extra for free.
      */
     private prepaidRowBalance;
+    /**
+     * Run spend the platform counts against maxTotalChargeUsd that this SDK does
+     * not charge itself (compute/proxy/browser usage, server-billed events).
+     * Learnt from the charge endpoint's remainingBudgetNd; only ever grows.
+     */
+    private platformOtherUsd;
+    private lastRemainingBudgetNd;
+    /** maxTotalChargeUsd minus this SDK's charges and the platform's other run spend. */
+    private remainingBudgetUsd;
+    /** Fold the last charge response's remainingBudgetNd into the local budget (monotonic). */
+    private syncPlatformBudget;
+    /** @internal Platform spend outside this SDK's charges (tests). */
+    _platformOtherUsd(): number;
     /** @internal Called by Actor shutdown before the final flush. */
     close(): void;
     /**

package/dist/charging.js

@@ -165,6 +165,31 @@ class ChargingManager {
      * Actors never go positive, so they get nothing extra for free.
      */
     prepaidRowBalance = 0;
+    /**
+     * Run spend the platform counts against maxTotalChargeUsd that this SDK does
+     * not charge itself (compute/proxy/browser usage, server-billed events).
+     * Learnt from the charge endpoint's remainingBudgetNd; only ever grows.
+     */
+    platformOtherUsd = 0;
+    lastRemainingBudgetNd = null;
+    /** maxTotalChargeUsd minus this SDK's charges and the platform's other run spend. */
+    remainingBudgetUsd() {
+        return this.maxTotalChargeUsd - this.calculateTotalChargedAmount() - this.platformOtherUsd;
+    }
+    /** Fold the last charge response's remainingBudgetNd into the local budget (monotonic). */
+    syncPlatformBudget() {
+        const nd = this.lastRemainingBudgetNd;
+        this.lastRemainingBudgetNd = null;
+        if (nd === null || nd < 0 || !Number.isFinite(this.maxTotalChargeUsd))
+            return;
+        const other = Number((this.maxTotalChargeUsd - nd / 1e9 - this.calculateTotalChargedAmount()).toFixed(9));
+        if (other > this.platformOtherUsd)
+            this.platformOtherUsd = other;
+    }
+    /** @internal Platform spend outside this SDK's charges (tests). */
+    _platformOtherUsd() {
+        return this.platformOtherUsd;
+    }
     /** @internal Called by Actor shutdown before the final flush. */
     close() {
         this._closed = true;
@@ -255,7 +280,7 @@ class ChargingManager {
         const rowCost = Object.entries(perRow).reduce((a, [name, n]) => a + (this.calculateEventPrice(name) ?? 0) * n, 0);
         let rows = rowCount;
         if (rowCost > 0 && Number.isFinite(this.maxTotalChargeUsd)) {
-            const fit = Math.floor(Number(((this.maxTotalChargeUsd - this.calculateTotalChargedAmount()) / rowCost).toFixed(4)));
+            const fit = Math.floor(Number((this.remainingBudgetUsd() / rowCost).toFixed(4)));
             rows = Math.min(rows, Math.max(0, fit));
         }
         return { perRow, rows };
@@ -543,7 +568,7 @@ class ChargingManager {
         return eventName;
     }
     calculateMaxChargesByPrice(price) {
-        const unroundedResult = (this.maxTotalChargeUsd - this.calculateTotalChargedAmount()) / price;
+        const unroundedResult = this.remainingBudgetUsd() / price;
         const roundedResult = Math.floor(Number(unroundedResult.toFixed(4)));
         return Math.max(0, roundedResult);
     }
@@ -651,6 +676,8 @@ class ChargingManager {
                 });
                 const body = extractChargeResponseBody(response);
                 const accepted = readAcceptedCount(body, intent.count);
+                const remaining = body.remainingBudgetNd;
+                this.lastRemainingBudgetNd = typeof remaining === 'number' && Number.isFinite(remaining) && remaining >= 0 ? remaining : null;
                 return accepted;
             }
             catch (err) {
@@ -956,6 +983,7 @@ class ChargingManager {
                 if (accepted < chargedCount)
                     this.markChargeLimitHit();
                 chargedCount = this.applyAcceptedCount(normalizedEventName, chargedCount, accepted, eventPricing.price);
+                this.syncPlatformBudget();
             }
             else {
                 throw new ChargeUncertainError(`Charge for event '${normalizedEventName}' (count=${chargedCount}) was not confirmed by the platform; operationId=${intent.idempotencyKey}`, {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "scrapely",
-    "version": "1.2.22",
+    "version": "1.2.23",
     "description": "Scrapely SDK for building JavaScript and TypeScript Actors",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
@@ -24,6 +24,7 @@
         "test:charging": "npx tsx --test tests/charging-pending.test.ts",
         "test:charge-limit-guard": "npx tsx --test tests/charge-limit-guard.test.ts",
         "test:charge-multi-event": "npx tsx --test tests/charge-multi-event.test.ts",
+        "test:charge-platform-budget": "npx tsx --test tests/charge-platform-budget.test.ts",
         "test:storage-retries": "npx tsx --test tests/storage-retries.test.ts",
         "test:push-idempotency": "npx tsx --test tests/push-idempotency.test.ts",
         "test:stdio-drain": "npx tsx --test tests/stdio-drain.test.ts",