plans

naive.plans is a control-plane accessor and exists on the root client only. A plan binds a price, an Account Kit and a set of per-period quotas; a tenant is put on one through billing.

await naive.plans.upsert({
  key: "pro",                       // your stable identifier — upsert is keyed on it
  name: "Pro",
  accountKitId: proKit.id,          // the kit applied when a tenant subscribes
  stripePriceId: "price_123",
  quotas: { seo: 1000, aeo: 250 },  // per period, per metered primitive
  period: "month",                  // "month" | "day"
});

const { plans } = await naive.plans.list();

Method	HTTP	Notes
`list()`	`GET /v1/plans`	Every plan you have defined.
`upsert({ key, name, accountKitId?, stripePriceId?, quotas?, period? })`	`POST /v1/plans`	Create or update, keyed on `key`.

Assign a tenant with naive.forUser(id).billing.setSubscription({ planKey: "pro", … }) — which applies the plan’s Account Kit by default. Metered primitives return 429 rate_limited once a tenant is over its quota for the period. This is the billing you charge your customers; your own Naive spend is Billing & Credits. See the Customer Billing guide.

SDK

Sub-clients