billing

// Plans (control plane — root client only)
await naive.plans.upsert({
  key: "pro",
  name: "Pro",
  accountKitId: proKit.id,
  stripePriceId: "price_123",
  quotas: { seo: 1000, aeo: 250 },
  period: "month",
});
const { plans } = await naive.plans.list();

// Subscription (per tenant) — assignKit defaults true (applies the plan's Account Kit)
await naive.forUser(userId).billing.setSubscription({
  planKey: "pro",
  status: "active",
  stripeCustomerId: "cus_123",
  stripeSubscriptionId: "sub_123",
  currentPeriodEnd: "2026-07-01T00:00:00Z",
});
await naive.forUser(userId).billing.getSubscription();

// Usage rollup + quotas for the current period
const usage = await naive.forUser(userId).billing.usage();
// { plan, status, period, quotas: { seo: 1000 }, usage: { seo: 42 } }