const subscription = await commerce.subscriptions.create({
  customerId: 'cus_123',
  priceId: 'price_pro_monthly',
  paymentMethod: 'pm_xxx'
})

await commerce.usage.record({
  subscriptionId: 'sub_123',
  metric: 'api_calls',
  quantity: 1000,
  timestamp: new Date()
})

const usage = await commerce.usage.get({
  subscriptionId: 'sub_123',
  startDate: '2026-01-01',
  endDate: '2026-01-31'
})

await commerce.subscriptions.cancel('sub_123', {
  reason: 'customer_request',
  cancelAtPeriodEnd: true  // finish current billing period
})

await commerce.subscriptions.update('sub_123', {
  priceId: 'price_enterprise_monthly',  // upgrade plan
  prorationBehavior: 'create_prorations'
})