feat(credits-admin): show per-period allotment in subscription block (#369)

Author: fbac

src/api/v2/credits-admin/handlers/account-view-get.ts

@@ -7,6 +7,8 @@ import {
   effectiveSubscriptionStatus,
   ENTITLED_SUBSCRIPTION_STATUSES,
 } from "@/subscriptions/status";
+import { tierGrant } from "@/subscriptions/tier-config";
+import { requireSubscriptionTier } from "@/subscriptions/tiers";
 import { prisma } from "@/utils/prisma";
 
 const DAY_MS = 24 * 60 * 60 * 1000;
@@ -54,6 +56,7 @@ export const accountViewGetHandler = async (
     environment: string | null;
     willRenew: boolean;
     isInTrial: boolean;
+    perPeriodCredits: number;
   } | null = null;
   let periodConsumesCredits = 0;
 
@@ -76,6 +79,10 @@ export const accountViewGetHandler = async (
       environment: subscription.environment ?? null,
       willRenew: subscription.willRenew,
       isInTrial: subscription.isInTrial,
+      perPeriodCredits: tierGrant(
+        requireSubscriptionTier(subscription.tier),
+        subscription.period,
+      ).perPeriod,
     };
   }
 

src/api/v2/credits-admin/handlers/admin-page.ts

@@ -251,6 +251,7 @@ function buildHTML(nonce: string, creditsPerUsd: number): string {
         "<tr><th>Effective status</th><td>" + esc(s.effectiveStatus) + "</td></tr>" +
         "<tr><th>Period</th><td>" + fmtDate(s.currentPeriodStart) + " → " + fmtDate(s.currentPeriodEnd) + "</td></tr>" +
         "<tr><th>Environment</th><td>" + esc(s.environment) + "</td></tr>" +
+        "<tr><th>Allotment (per period)</th><td>" + fmtCredits(s.perPeriodCredits) + " credits</td></tr>" +
         "<tr><th>Period consumes</th><td>" + fmtCredits(j.periodConsumesCredits) + " credits</td></tr>" +
         "</tbody></table>";
     } else {

tests/credits-admin/account-view.integration.test.ts

@@ -23,6 +23,7 @@ type AccountViewBody = {
     environment: string | null;
     willRenew: boolean;
     isInTrial: boolean;
+    perPeriodCredits: number;
   } | null;
   isEntitled: boolean;
   balanceCredits: string;
@@ -66,6 +67,7 @@ describe("GET /api/v2/credits-admin/accounts/:accountId", () => {
     expect(body.isEntitled).toBe(true);
     expect(body.subscription?.effectiveStatus).toBe("active");
     expect(BigInt(body.balanceCredits)).toBeGreaterThan(0n);
+    expect(body.subscription?.perPeriodCredits).toBeGreaterThan(0);
   });
 
   it("non-subscriber → no subscription, single wallet balance", async () => {

tests/credits-admin/admin-page.test.ts

@@ -40,4 +40,10 @@ describe("credits-admin page", () => {
     expect(res.text).toContain('id="usage-spark"');
     expect(res.text).toContain("usageDaily");
   });
+
+  it("renders the per-period allotment in the subscription block", async () => {
+    const res = await adminRequest(app, false).get("/api/v2/credits-admin/");
+    expect(res.text).toContain("Allotment");
+    expect(res.text).toContain("perPeriodCredits");
+  });
 });