Supercharge your AI agents with data from the web and beyond. Building the library for superintelligence. 🔥
TypeScript aiai-agentsai-crawlerai-scrapingai-searchcrawlerdata-extractionhtml-to-markdownllmmarkdownscraperscrapingweb-crawlerweb-dataweb-data-extractionweb-scraperweb-scrapingweb-searchwebscraping
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.tsindex 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.tsindex 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)// ---------------------------------------------------------------------------