Struct EntitlementCache 

pub struct EntitlementCache { /* private fields */ }

Implementations

impl EntitlementCache

pub fn new(public_key: &[u8; 32], billing_url: &str) -> Result<Self, KeyError>

public_key is monetize’s 32-byte Ed25519 verifying key; billing_url is the pay page template, e.g. https://gunnar.rs/billing/{tenant}.

pub fn public_key(&self) -> &VerifyingKey

pub fn allows(&self, tenant: &TenantId, action: Action) -> Verdict

The hot path. See the crate doc for its cost.

pub fn notice(&self, tenant: &TenantId) -> Option<String>

The Grace banner / report-status warning, if the tenant is in Grace.

pub fn state(&self, tenant: &TenantId) -> State

The state the cache holds for tenant; Free when unknown.

pub fn fact(&self, tenant: &TenantId) -> Option<EntitlementFact>

A copy of the whole fact (caps, paid_until, source) for the product’s own checks.

pub fn issued_unix_ms(&self) -> u64

The issue time of the snapshot the cache holds (0 before the first refresh).

pub fn len(&self) -> usize

pub fn is_empty(&self) -> bool

pub fn refresh(&self, snapshot_bytes: &[u8]) -> Result<usize, RefreshError>

Replace everything with a signed Snapshot (its JSON bytes). Nothing changes unless the envelope and every fact verify and the snapshot is not older than the one held. Returns the number of tenants now known.

pub fn push(&self, fact: EntitlementFact) -> Result<(), SignatureError>

One pushed fact. Verified before it replaces the tenant’s current fact.