🥮 mooncakes.io

gaato/discord/cache does not have a README file

CacheLimit

source
pub struct CacheLimit {
  // private fields
}

Bounds one cached resource by entry count, lifetime, or both.

Negative limits clamp to zero. A max_entries of zero retains nothing, while a ttl_ms of zero makes entries expire immediately. TTL deadlines are fixed when an entry is written and are never extended by reads; expiry is enforced lazily without background timers.

CacheLimit::CacheLimit

source
fn CacheLimit::CacheLimit(max_entries? : Int, ttl_ms? : Int64) -> CacheLimit

Create an optional entry-count and TTL limit for one resource.

CacheLimits

source
pub struct CacheLimits {
  // private fields
}

Per-resource bounds for an in-memory cache.

Guild, channel, and user limits are global. Role, member, voice-state, and presence limits apply independently per guild; message limits apply independently per channel. The unavailable-guild flags and the channel-to-guild index are small bookkeeping state and remain unbounded. TTLs use fixed, non-sliding deadlines set at write time and are enforced lazily without background timers.

CacheLimits::CacheLimits

source
fn CacheLimits::CacheLimits(guilds? : CacheLimit, channels? : CacheLimit, users? : CacheLimit, roles? : CacheLimit, members? : CacheLimit, voice_states? : CacheLimit, presences? : CacheLimit, messages? : CacheLimit) -> CacheLimits

Configure limits for each resource. Messages retain at most 100 entries per channel by default; other resources are unbounded by default.

CacheLimits::default

source
fn CacheLimits::default() -> CacheLimits

The default per-resource limits (see CacheLimits).

CacheResources

source
pub struct CacheResources {
  // private fields
}

Selects which gateway resources an in-memory cache retains.

Guilds, channels, roles, members, users, and voice states are enabled by default. Presences and messages are opt-in because they are high-churn and can dominate memory use on larger bots.

CacheResources::CacheResources

source
fn CacheResources::CacheResources(guilds? : Bool, channels? : Bool, roles? : Bool, members? : Bool, users? : Bool, voice_states? : Bool, presences? : Bool, messages? : Bool) -> CacheResources

Select the retained resources individually; unspecified flags keep their defaults (all on except presences and messages).

CacheResources::all

source

Retain every resource, including high-churn presences and messages.

CacheResources::default

source

The default selection (see CacheResources).

CacheResources::none

source

Retain nothing; enable resources from this baseline for a minimal cache.

InMemoryCache

source
pub struct InMemoryCache {
  // private fields
}

A gateway-driven, resource-selective in-memory cache.

update is the only mutation entry point. Entity getters return the model value retained by the cache; callers should treat it as immutable. List getters always allocate a new outer array so callers cannot mutate the cache's collections.

InMemoryCache::InMemoryCache

source
fn InMemoryCache::InMemoryCache(resources~ : CacheResources, limits? : CacheLimits, now? : () -> Int64) -> InMemoryCache

Create an empty cache retaining the selected resources under the per-resource limits. Feed it gateway events via Bot::attach_cache (or call update manually). TTL deadlines are fixed at write time and expiry is enforced lazily without background timers.

InMemoryCache::channel

source

The cached channel or thread, if retained.

InMemoryCache::channels

source

All cached channels and threads.

InMemoryCache::guild

source

The cached guild, if retained.

InMemoryCache::guilds

source

All cached guilds.

InMemoryCache::is_guild_unavailable

source

Whether the guild is currently marked unavailable by a GUILD_DELETE outage notice.

InMemoryCache::member

source

The cached guild member, if retained.

InMemoryCache::members

source

All cached members of a guild (only members seen in events unless the privileged GUILD_MEMBERS intent fills the cache).

InMemoryCache::message

source

The cached message, if still retained.

InMemoryCache::messages

source

Cached messages of a channel, oldest first, capped by the messages limit.

InMemoryCache::permissions

source

Computes guild-level permissions from the cached guild, member, and roles.

InMemoryCache::permissions_in

source

Computes channel permissions using the cached base resources and channel overwrites. Returns None when any required cache resource is disabled or absent.

InMemoryCache::presence

source

The cached presence of a user in a guild, if presences are retained.

InMemoryCache::presences

source

All cached presences of a guild.

InMemoryCache::role

source

The cached role, if retained.

InMemoryCache::roles

source

All cached roles of a guild.

InMemoryCache::unavailable_guilds

source

Ids of guilds currently marked unavailable.

InMemoryCache::update

source
fn InMemoryCache::update(self : InMemoryCache, event : 
Event) -> Unit

Applies one decoded gateway event. Unsupported events are intentionally ignored for forward compatibility.

InMemoryCache::user

source

The cached user, if retained.

InMemoryCache::users

source

All cached users.

InMemoryCache::voice_state

source

The cached voice state of a user in a guild, if any.

InMemoryCache::voice_states

source

All cached voice states of a guild.

Source Files

Powered by MoonBit

Site sourceReport issuePackagesBuild queueSkillsStatistics

© 2026 mooncakes.io