Struct CacheConfig 

pub struct CacheConfig {
    pub group_cache: CacheEntryConfig,
    pub device_registry_cache: CacheEntryConfig,
    pub lid_pn_cache: CacheEntryConfig,
    pub recent_messages: CacheEntryConfig,
    pub message_retry_counts: CacheEntryConfig,
    pub undecryptable_dispatched: CacheEntryConfig,
    pub pdo_pending_requests: CacheEntryConfig,
    pub sender_key_devices_cache: CacheEntryConfig,
    pub session_locks_capacity: u64,
    pub chat_lanes_capacity: u64,
    pub sent_message_ttl_secs: u64,
    pub cache_stores: CacheStores,
}

Configuration for all client caches and resource pools.

All fields default to WhatsApp Web behavior. Use ..Default::default() to override only specific settings.

Example — tune TTL/capacity

use whatsapp_rust::{CacheConfig, CacheEntryConfig};
use std::time::Duration;

let config = CacheConfig {
    group_cache: CacheEntryConfig::new(None, 1_000), // no TTL
    ..Default::default()
};

Example — Redis for group and device registry caches

use std::sync::Arc;
use whatsapp_rust::{CacheConfig, CacheStores};

let redis = Arc::new(MyRedisCacheStore::new("redis://localhost:6379"));
let config = CacheConfig {
    cache_stores: CacheStores {
        group_cache: Some(redis.clone()),
        device_registry_cache: Some(redis.clone()),
        ..Default::default()
    },
    ..Default::default()
};

Fields

group_cache: CacheEntryConfig

Group metadata cache (time_to_live). Default: 1h TTL, 250 entries.

device_registry_cache: CacheEntryConfig

Device registry cache (time_to_live). Default: 1h TTL, 1000 entries.

lid_pn_cache: CacheEntryConfig

LID-to-phone cache. WAWebLidPnCache uses plain Maps with no expiry and no size cap; evicting a still-valid mapping silently downgrades Signal addresses to @c.us. Default: no timeout, capacity u64::MAX (effectively unbounded — moka doesn’t expose an unbounded() builder).

recent_messages: CacheEntryConfig

Optional L1 in-memory cache for sent messages (retry support). Default: capacity 0 (disabled — DB-only, matching WA Web). Set capacity > 0 to enable a fast in-memory cache in front of the DB.

message_retry_counts: CacheEntryConfig

Message retry counts (time_to_live). Default: 5m TTL, 500 entries.

undecryptable_dispatched: CacheEntryConfig

Dedup key for UndecryptableMessage dispatch so a server resend of the same id does not surface a second notification. Default: 5m TTL, 1000 entries.

pdo_pending_requests: CacheEntryConfig

PDO pending requests (time_to_live). Default: 30s TTL, 200 entries.

sender_key_devices_cache: CacheEntryConfig

Sender key device tracking cache (time_to_idle). Default: 1h TTI, 500 entries. Caches per-group SKDM distribution state to avoid DB reads on every group send.

session_locks_capacity: u64

Per-device Signal session lock capacity. Default: 10000.

chat_lanes_capacity: u64

Per-chat lane capacity (combined lock + queue). Default: 5000.

sent_message_ttl_secs: u64

TTL in seconds for sent messages in DB before periodic cleanup. 0 = no automatic cleanup. Default: 300 (5 minutes).

cache_stores: CacheStores

Per-cache custom store overrides.

For each field set to Some(store), the corresponding cache uses that backend instead of the default in-process moka cache. Fields left as None keep the default moka behaviour.

Coordination caches (session_locks, chat_lanes), the signal write-behind cache, and pdo_pending_requests always stay in-process — they hold live Rust objects (mutexes, channel senders, oneshot senders) that cannot be serialised to an external store.

Trait Implementations

impl Clone for CacheConfig

fn clone(&self) -> CacheConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CacheConfig

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for CacheConfig

fn default() -> Self

Returns the “default value” for a type.