fix(billing): key the free-tier surfaces off code_usage_subscribed

Follow the field rename from posthog#71315: isCodeUsageUnbilled becomes
isCodeUsageFreeTier and reads code_usage_subscribed, matching the wire name
and the plans-page card language.

Generated-By: PostHog Code
Task-Id: 1039ea23-9930-44e2-9888-b05cf8b129ec

Author: adboio

packages/core/src/billing/usageDisplay.test.ts

@@ -2,7 +2,7 @@ import { describe, expect, it } from "vitest";
 import type { UsageOutput } from "../usage/schemas";
 import {
   formatResetTime,
-  isCodeUsageUnbilled,
+  isCodeUsageFreeTier,
   isUsageExceeded,
 } from "./usageDisplay";
 
@@ -57,19 +57,21 @@ describe("isUsageExceeded", () => {
   });
 });
 
-describe("isCodeUsageUnbilled", () => {
+describe("isCodeUsageFreeTier", () => {
   it.each([
     [false, true],
     [true, false],
     // Absent means unknown, never free.
     [undefined, false],
-  ] as const)("code_usage_billed=%s -> %s", (billed, expected) => {
-    expect(isCodeUsageUnbilled({ code_usage_billed: billed })).toBe(expected);
+  ] as const)("code_usage_subscribed=%s -> %s", (subscribed, expected) => {
+    expect(isCodeUsageFreeTier({ code_usage_subscribed: subscribed })).toBe(
+      expected,
+    );
   });
 
   it("treats missing usage as not confirmed free", () => {
-    expect(isCodeUsageUnbilled(null)).toBe(false);
-    expect(isCodeUsageUnbilled(undefined)).toBe(false);
+    expect(isCodeUsageFreeTier(null)).toBe(false);
+    expect(isCodeUsageFreeTier(undefined)).toBe(false);
   });
 });
 

packages/core/src/billing/usageDisplay.ts

@@ -1,14 +1,10 @@
 import type { UsageOutput } from "../usage/schemas";
 
-/**
- * The org is confirmed on the free tier. False when billed OR unknown —
- * `code_usage_billed` is absent on gateways predating the field, and absence
- * must never read as free.
- */
-export function isCodeUsageUnbilled(
-  usage: Pick<UsageOutput, "code_usage_billed"> | null | undefined,
+/** Confirmed free tier only — an absent `code_usage_subscribed` is unknown, never free. */
+export function isCodeUsageFreeTier(
+  usage: Pick<UsageOutput, "code_usage_subscribed"> | null | undefined,
 ): boolean {
-  return usage?.code_usage_billed === false;
+  return usage?.code_usage_subscribed === false;
 }
 
 export function isUsageExceeded(usage: UsageOutput): boolean {

packages/ui/src/features/billing/useFreeUsage.ts

@@ -1,4 +1,4 @@
-import { isCodeUsageUnbilled } from "@posthog/core/billing/usageDisplay";
+import { isCodeUsageFreeTier } from "@posthog/core/billing/usageDisplay";
 import type { UsageOutput } from "@posthog/core/usage/schemas";
 import { useUsage } from "./useUsage";
 
@@ -13,9 +13,9 @@ export function useFreeUsage(billingEnabled: boolean): FreeUsageResult {
   const { usage, isLoading } = useUsage({ enabled: billingEnabled });
 
   if (!billingEnabled) return { usage: null, isLoading: false };
-  // Only confirmed-unbilled orgs have a meaningful free-tier meter — billed
-  // orgs have no per-user caps, and unknown must not render as free.
-  if (!isCodeUsageUnbilled(usage)) {
+  // Only confirmed free-tier orgs have a meaningful free-tier meter —
+  // subscribed orgs have no per-user caps, and unknown must not render as free.
+  if (!isCodeUsageFreeTier(usage)) {
     return { usage: null, isLoading: usage ? false : isLoading };
   }
   return { usage: usage ?? null, isLoading };

packages/ui/src/features/settings/sections/PlanUsageSettings.tsx

@@ -3,7 +3,7 @@ import {
   CreditCard,
   WarningCircle,
 } from "@phosphor-icons/react";
-import { isCodeUsageUnbilled } from "@posthog/core/billing/usageDisplay";
+import { isCodeUsageFreeTier } from "@posthog/core/billing/usageDisplay";
 import {
   Empty,
   EmptyDescription,
@@ -29,7 +29,7 @@ import { useEffect } from "react";
  * Plan & usage under usage-based billing: no seats or plans to manage in-app —
  * payment methods, spend limits, and org-level usage live on the PostHog
  * billing page. The free-tier meters show the per-user allowance for
- * confirmed-unbilled orgs; billed orgs have no per-user caps to meter.
+ * confirmed free-tier orgs; subscribed orgs have no per-user caps to meter.
  */
 export function PlanUsageSettings() {
   const billingEnabled = useFeatureFlag(BILLING_FLAG);
@@ -56,9 +56,9 @@ export function PlanUsageSettings() {
     burstUsedPercent: usage?.burst.used_percent ?? null,
   });
 
-  // Tri-state: unknown (absent field) must render as billed, never as free.
-  const unbilled = isCodeUsageUnbilled(usage);
-  const billed = usage?.code_usage_billed === true;
+  // Tri-state: unknown (absent field) must render as subscribed, never free.
+  const freeTier = isCodeUsageFreeTier(usage);
+  const subscribed = usage?.code_usage_subscribed === true;
   const orgLimitReached = usage?.ai_credits?.exhausted === true;
 
   const openBilling = () => {
@@ -121,26 +121,26 @@ export function PlanUsageSettings() {
             <Flex align="center" justify="between">
               <Flex direction="column" gap="1">
                 <Text className="font-bold text-base">
-                  {unbilled ? "Free tier" : "Usage-based billing"}
+                  {freeTier ? "Free tier" : "Usage-based billing"}
                 </Text>
                 <Text className="text-(--gray-11) text-sm">
-                  {unbilled
+                  {freeTier
                     ? "Your organization's first $20 of usage each month is included, with access to open models. Add a payment method to unlock premium models — you only pay for what you use."
                     : "Your organization pays for PostHog Code usage at cost — no seats, no subscriptions. The first $20 each month is included."}
                 </Text>
               </Flex>
-              {billed && (
+              {subscribed && (
                 <Badge variant="soft" color="green" radius="full">
                   Active
                 </Badge>
               )}
             </Flex>
             <Button
               size="1"
-              variant={unbilled ? "solid" : "outline"}
+              variant={freeTier ? "solid" : "outline"}
               disabled={!billingUrl}
               onClick={() => {
-                if (unbilled) {
+                if (freeTier) {
                   track(ANALYTICS_EVENTS.UPGRADE_PROMPT_CLICKED, {
                     surface: "plan_page_card",
                   });
@@ -149,7 +149,7 @@ export function PlanUsageSettings() {
               }}
               className="self-start"
             >
-              {unbilled
+              {freeTier
                 ? "Add payment method"
                 : "Manage billing and spend limits"}
               <ArrowSquareOut size={12} />
@@ -167,7 +167,7 @@ export function PlanUsageSettings() {
               >
                 <Spinner size="2" />
               </Flex>
-            ) : unbilled && usage ? (
+            ) : freeTier && usage ? (
               <Flex direction="column" gap="3">
                 <UsageMeter
                   label="Monthly free usage"