Quota Management

import { quotas } from '@axiljs/cloud'
 
quotas.configure({
  tenantId: 'acme-corp',
  limits: [
    { metric: 'api_calls',     max: 100_000,          period: 'monthly' },
    { metric: 'storage_bytes', max: 5_000_000_000,    period: 'lifetime' },
    { metric: 'users',         max: 500,              period: 'lifetime' },
  ],
})

const allowed = quotas.increment('acme-corp', 'api_calls')
 
if (!allowed) {
  res.status(429).json({ error: 'API quota exceeded' })
  return
}

if (!quotas.check('acme-corp', 'api_calls')) {
  // Quota exhausted — block the request
}

const usage = quotas.getUsage('acme-corp')
// [
//   { metric: 'api_calls', current: 45200, limit: 100000, percentUsed: 45, period: 'monthly' },
//   { metric: 'users', current: 120, limit: 500, percentUsed: 24, period: 'lifetime' },
// ]

import { getGlobalEventBus } from '@axiljs/events'
 
// Warning at 90% usage
getGlobalEventBus().on('quota.warning', ({ tenantId, metric, percentUsed }) => {
  notifyAdmin(`${tenantId} is at ${percentUsed}% of ${metric}`)
})
 
// Hard limit exceeded
getGlobalEventBus().on('quota.exceeded', ({ tenantId, metric, current, limit }) => {
  alertTeam(`${tenantId} exceeded ${metric}: ${current}/${limit}`)
})