Struct AppState 

pub struct AppState {
    pub map_tile_cache: Arc<Mutex<MapTileCache>>,
    pub region_cache: Arc<Mutex<RegionNameToGridCoordinatesCache>>,
    pub jobs: Arc<JobStore>,
    pub config: Arc<Config>,
    pub db: SqlitePool,
    pub cookie_key: Key,
    pub library_cleanup_dirty: Arc<AtomicBool>,
    pub glw_event_cache: Arc<Mutex<GlwEventCache>>,
    pub fonts: Arc<FontDirectory>,
}

State shared between all axum handlers.

The two cache types both require &mut self to drive lookups, so they are wrapped in async Mutexes. As a side effect this serialises renders to one at a time; that is acceptable for v1 because each render is also bounded by the upstream rate limiter.

Fields

map_tile_cache: Arc<Mutex<MapTileCache>>

the on-disk + in-memory cache of map tiles, shared with the CLI.

region_cache: Arc<Mutex<RegionNameToGridCoordinatesCache>>

the region name <-> grid coordinates cache.

jobs: Arc<JobStore>

the in-memory store of running and recently completed render jobs.

config: Arc<Config>

the runtime configuration.

db: SqlitePool

SQLite pool used by the auth subsystem (users, sessions, set-password tokens). Cheap to clone.

cookie_key: Key

signing key for the session cookie, derived from the configured session_signing_key at startup. Key is internally a buffer of bytes; cloning is cheap.

library_cleanup_dirty: Arc<AtomicBool>

in-process flag raised whenever a code path may have produced stale files under <storage_dir>/renders/ without unlinking them inline (e.g. a cascade delete from removing a group). The orphan sweeper only scans the filesystem when this flag is set so an idle server does no filesystem work.

glw_event_cache: Arc<Mutex<GlwEventCache>>

three-tier cache (memory LRU + redb + http-cache-semantics) for GLW events. Created at startup from config.cache_dir like the CLI does. Used by render workers when a render requests a GLW overlay via event id or event key.

fonts: Arc<FontDirectory>

fonts discovered under config.fonts_directory at startup. Surfaced through GET /api/fonts and used by render workers to resolve a client-supplied font_id to the font file path.

Trait Implementations

impl Clone for AppState

fn clone(&self) -> AppState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for AppState

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

Formats the value using the given formatter.

impl FromRef<AppState> for Key

fn from_ref(input: &AppState) -> Self

Converts to this type from a reference to the input type.

impl FromRequestParts<AppState> for CurrentUser

type Rejection = Error

If the extractor fails it’ll use this “rejection” type. A rejection is a kind of error that can be converted into a response.

async fn from_request_parts( parts: &mut Parts, state: &AppState, ) -> Result<Self, Self::Rejection>

Perform the extraction.

impl FromRequestParts<AppState> for LslBearer

type Rejection = Error

If the extractor fails it’ll use this “rejection” type. A rejection is a kind of error that can be converted into a response.

async fn from_request_parts( parts: &mut Parts, state: &AppState, ) -> Result<Self, Self::Rejection>

Perform the extraction.

impl FromRequestParts<AppState> for ClientIp

type Rejection = Infallible

If the extractor fails it’ll use this “rejection” type. A rejection is a kind of error that can be converted into a response.

async fn from_request_parts( parts: &mut Parts, state: &AppState, ) -> Result<Self, Self::Rejection>

Perform the extraction.