Skip to content

Supercharge your AI agents with data from the web and beyond. Building the library for superintelligence. 🔥

fix(credits): surface negative remaining credits for overage (#3724)

firecrawl-spring[bot]5cc12e43f0bc
diff --git a/apps/api/src/services/autumn/__tests__/usage.test.ts b/apps/api/src/services/autumn/__tests__/usage.test.ts
index 857dd578a..95e1d1f08 100644
--- a/apps/api/src/services/autumn/__tests__/usage.test.ts
+++ b/apps/api/src/services/autumn/__tests__/usage.test.ts
@@ -703,6 +703,38 @@ describe("getTeamBalance", () => {
expect(result!.unlimited).toBe(true);
expect(result!.usage).toBe(12345);
});
+
+ // Autumn caps `balance.remaining` at 0, so the raw field can't show
+ // negative balances for teams in overage. We derive the signed value from
+ // granted - usage instead.
+ it("returns a negative remaining when usage exceeds granted (overage)", async () => {
+ mockEntitiesGet.mockResolvedValue({
+ balances: {
+ CREDITS: {
+ remaining: 0,
+ granted: 25250000,
+ usage: 29688178,
+ unlimited: false,
+ overage_allowed: false,
+ breakdown: [{ planId: "enterprise", includedGrant: 10000000 }],
+ },
+ },
+ subscriptions: [
+ {
+ status: "active",
+ currentPeriodStart: 1712444524000,
+ currentPeriodEnd: 1715036524000,
+ },
+ ],
+ });
+
+ const result = await getTeamBalance("team-1");
+
+ expect(result).not.toBeNull();
+ expect(result!.remaining).toBe(-4438178);
+ expect(result!.granted).toBe(25250000);
+ expect(result!.usage).toBe(29688178);
+ });
});
// ---------------------------------------------------------------------------
diff --git a/apps/api/src/services/autumn/usage.ts b/apps/api/src/services/autumn/usage.ts
index c67ccc58b..82c1252a9 100644
--- a/apps/api/src/services/autumn/usage.ts
+++ b/apps/api/src/services/autumn/usage.ts
@@ -307,7 +307,7 @@ export async function getTeamBalance(
}
return {
- remaining: creditBalance?.remaining ?? 0,
+ remaining: signedRemaining(creditBalance),
granted: creditBalance?.granted ?? 0,
planCredits,
usage: creditBalance?.usage ?? 0,
@@ -319,6 +319,23 @@ export async function getTeamBalance(
};
}
+// Autumn caps `balance.remaining` at 0, so it can't surface negative balances
+// for teams in overage. `granted - usage` preserves the signed balance.
+function signedRemaining(
+ balance:
+ | {
+ granted?: number;
+ usage?: number;
+ remaining?: number;
+ unlimited?: boolean;
+ }
+ | undefined,
+): number {
+ if (!balance) return 0;
+ if (balance.unlimited === true) return balance.remaining ?? 0;
+ return (balance.granted ?? 0) - (balance.usage ?? 0);
+}
+
// ---------------------------------------------------------------------------
// Historical usage (across billing periods)
// ---------------------------------------------------------------------------