feat(billing): consume plan variant catalog

Fetch the public billing catalog during account config load and use durable plan IDs from /v1/me for display, analytics, and upgrade/manage labels.

Renderer billing surfaces now resolve plan display data from the catalog and show Unknown when the backend returns an unmapped plan ID.

apps/x/packages/core/src/analytics/identify.ts

@@ -14,7 +14,7 @@ export async function identifyIfSignedIn(): Promise<void> {
     if (!billing.userId) return;
     identify(billing.userId, {
       ...(billing.userEmail ? { email: billing.userEmail } : {}),
-      plan: billing.subscriptionPlan,
+      plan: billing.subscriptionPlanId,
       status: billing.subscriptionStatus,
     });
   } catch (err) {

apps/x/packages/core/src/billing/billing.ts

@@ -1,8 +1,10 @@
 import { getAccessToken } from '../auth/tokens.js';
 import { API_URL } from '../config/env.js';
-import type { BillingInfo, BillingPlan } from '@x/shared/dist/billing.js';
+import type { BillingInfo, BillingPlanId } from '@x/shared/dist/billing.js';
+import { getRowboatConfig } from '../config/rowboat.js';
 
 export async function getBillingInfo(): Promise<BillingInfo> {
+  const config = await getRowboatConfig();
   const accessToken = await getAccessToken();
   const response = await fetch(`${API_URL}/v1/me`, {
     headers: { Authorization: `Bearer ${accessToken}` },
@@ -16,7 +18,7 @@ export async function getBillingInfo(): Promise<BillingInfo> {
       email: string;
     };
     billing: {
-      plan: BillingPlan | null;
+      planId: BillingPlanId | null;
       status: string | null;
       trialExpiresAt: string | null;
       usage: {
@@ -37,9 +39,10 @@ export async function getBillingInfo(): Promise<BillingInfo> {
   return {
     userEmail: body.user.email ?? null,
     userId: body.user.id ?? null,
-    subscriptionPlan: body.billing.plan,
+    subscriptionPlanId: body.billing.planId,
     subscriptionStatus: body.billing.status,
     trialExpiresAt: body.billing.trialExpiresAt ?? null,
+    catalog: config.billing,
     monthly: body.billing.usage.monthly,
     daily: body.billing.usage.daily,
   };

apps/x/packages/shared/src/billing.ts

@@ -1,7 +1,26 @@
 import { z } from 'zod';
 
-export const BillingPlanSchema = z.enum(['free', 'starter', 'pro']);
-export type BillingPlan = z.infer<typeof BillingPlanSchema>;
+export const BillingPlanCategorySchema = z.enum(['free', 'starter', 'pro']);
+export type BillingPlanCategory = z.infer<typeof BillingPlanCategorySchema>;
+
+export const BillingPlanIdSchema = z.string().min(1);
+export type BillingPlanId = z.infer<typeof BillingPlanIdSchema>;
+
+export const BillingCatalogPlanSchema = z.object({
+  id: BillingPlanIdSchema,
+  category: BillingPlanCategorySchema,
+  displayName: z.string(),
+  monthlyCredits: z.number(),
+  dailyCredits: z.number(),
+  monthlyPriceCents: z.number().nullable(),
+  archived: z.boolean().optional(),
+});
+export type BillingCatalogPlan = z.infer<typeof BillingCatalogPlanSchema>;
+
+export const BillingCatalogSchema = z.object({
+  plans: z.array(BillingCatalogPlanSchema),
+});
+export type BillingCatalog = z.infer<typeof BillingCatalogSchema>;
 
 export const BillingUsageBucketSchema = z.object({
   sanctionedCredits: z.number(),
@@ -13,12 +32,21 @@ export type BillingUsageBucket = z.infer<typeof BillingUsageBucketSchema>;
 export const BillingInfoSchema = z.object({
   userEmail: z.string().nullable(),
   userId: z.string().nullable(),
-  subscriptionPlan: BillingPlanSchema.nullable(),
+  subscriptionPlanId: BillingPlanIdSchema.nullable(),
   subscriptionStatus: z.string().nullable(),
   trialExpiresAt: z.string().nullable(),
+  catalog: BillingCatalogSchema,
   monthly: BillingUsageBucketSchema,
   daily: BillingUsageBucketSchema.extend({
     usageDay: z.string(),
   }),
 });
 export type BillingInfo = z.infer<typeof BillingInfoSchema>;
+
+export function getBillingPlanData(
+  catalog: BillingCatalog,
+  planId: string | null | undefined,
+): BillingCatalogPlan | null {
+  if (!planId) return null;
+  return catalog.plans.find((plan) => plan.id === planId) ?? null;
+}

apps/x/packages/shared/src/rowboat-account.ts

@@ -1,7 +1,9 @@
 import { z } from 'zod';
+import { BillingCatalogSchema } from './billing.js';
 
 export const RowboatApiConfig = z.object({
   appUrl: z.string(),
   websocketApiUrl: z.string(),
   supabaseUrl: z.string(),
+  billing: BillingCatalogSchema,
 });