useEntitlements

import { useCheckEntitlement } from "@billingos/sdk";

const { data } = useCheckEntitlement("cus_123", "custom_branding");
// data.has_access: boolean
// data.limit: number | undefined
// data.usage: number | undefined

import { useHasFeature } from "@billingos/sdk";

const canExport = useHasFeature("cus_123", "export_pdf");

if (canExport) {
  // Show export button
}

import { useEntitlements } from "@billingos/sdk";

const { data } = useEntitlements("cus_123");

// data: Entitlement[]

import { useIsApproachingLimit } from "@billingos/sdk";

const isNearLimit = useIsApproachingLimit("cus_123", "api_calls", 80);

if (isNearLimit) {
  // Show upgrade nudge
}

interface Entitlement {
  feature_key: string
  has_access: boolean
  limit?: number
  usage?: number
  metadata?: Record<string, string>
}