Struct CacheConfig 

pub struct CacheConfig {

    pub group_cache: CacheEntryConfig,
    pub device_cache: CacheEntryConfig,
    pub device_registry_cache: CacheEntryConfig,
    pub lid_pn_cache: CacheEntryConfig,
    pub retried_group_messages: CacheEntryConfig,
    pub recent_messages: CacheEntryConfig,
    pub message_retry_counts: CacheEntryConfig,
    pub pdo_pending_requests: CacheEntryConfig,
    pub session_locks_capacity: u64,
    pub message_queues_capacity: u64,
    pub message_enqueue_locks_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 caches only

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_cache: Some(redis.clone()),
        ..Default::default()
    },
    ..Default::default()
};

Fields

group_cache: CacheEntryConfig

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

device_cache: CacheEntryConfig

Device list cache (time_to_live). Default: 1h TTL, 5000 entries.

device_registry_cache: CacheEntryConfig

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

lid_pn_cache: CacheEntryConfig

LID-to-phone cache (time_to_idle). Default: 1h timeout, 10000 entries.

retried_group_messages: CacheEntryConfig

Retried group messages tracker (time_to_live). Default: 5m TTL, 2000 entries.

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, 1000 entries.

pdo_pending_requests: CacheEntryConfig

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

session_locks_capacity: u64

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

message_queues_capacity: u64

Per-chat message processing queue capacity. Default: 2000.

message_enqueue_locks_capacity: u64

Per-chat message enqueue lock capacity. Default: 2000.

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, message_queues, message_enqueue_locks), 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.