Entitlements Overview

import { Nozle } from '@nozle-js/node'

const nozle = new Nozle() // reads NOZLE_SECRET_KEY

const check = await nozle.can('customer_123', 'api_calls')

if (!check.allowed) {
  return Response.json(
    { error: check.reason ?? 'not_allowed', remaining: check.remaining },
    { status: 403 },
  )
}

if (check.overage) {
  // Allowed: a soft limit is reached, so this usage is billed as overage.
  notifyOverage(check)
}

return performProtectedWork()

import { FeatureGate, UpgradePrompt } from '@nozle-js/react'

<FeatureGate
  allowed={entitlement.allowed}
  loading={entitlement.loading}
  fallback={<UpgradePrompt planName="Growth" />}
>
  <Dashboard />
</FeatureGate>