Struct AppState 

pub struct AppState {

    pub config: Arc<Config>,
    pub store: DatabaseAdapter,
    pub cache: WhatCache,
    pub components: Arc<ComponentRegistry>,
    pub engine: Arc<RenderEngine>,
    pub root: PathBuf,
    pub content_dir: PathBuf,
    pub sessions: Option<SessionBackend>,
    pub auth: AuthHandler,
    pub dev_mode: bool,
    pub css_mode: CssMode,
    pub live_reload_tx: Option<Sender<LiveReloadMessage>>,
    pub wired_tx: Sender<WiredMessage>,
    pub wired_scopes: Arc<RwLock<HashMap<String, WiredScope>>>,
    pub app_scopes: Arc<RwLock<HashMap<String, WiredScope>>>,
    pub policies: Arc<PolicyRegistry>,
    pub data_source_loaded: Arc<RwLock<HashMap<String, Instant>>>,
    pub rate_limiters: Option<RateLimiters>,
    pub log_level: String,
    pub jobs: JobQueue,
    pub http_client: Client,
    pub upload_backend: Option<UploadBackend>,
    pub datasources: HashMap<String, Datasource>,
    pub wired_client_count: Arc<AtomicUsize>,
    pub validated_actions: Arc<RwLock<HashSet<String>>>,
    pub activity_log: Arc<Mutex<VecDeque<ActivityEvent>>>,
}

Application state shared across handlers

Fields

config: Arc<Config>

Configuration

store: DatabaseAdapter

Data store (SQLite, D1, or Supabase — configured via [database] in what.toml)

cache: WhatCache

Cache

components: Arc<ComponentRegistry>

Component registry

engine: Arc<RenderEngine>

Render engine

root: PathBuf

Project root directory

content_dir: PathBuf

Resolved content directory path (root + “site” or “pages”)

sessions: Option<SessionBackend>

Session store (pluggable: SQLite or Cloudflare KV)

auth: AuthHandler

Authentication handler

dev_mode: bool

Development mode flag

css_mode: CssMode

Framework stylesheet mode ([server] css in what.toml), validated at startup

live_reload_tx: Option<Sender<LiveReloadMessage>>

Live reload broadcast sender (only active in dev mode)

wired_tx: Sender<WiredMessage>

Wired state broadcast sender (real-time push with scope filtering)

wired_scopes: Arc<RwLock<HashMap<String, WiredScope>>>

Scope registry for wired variables (rebuilt on application.what reload)

app_scopes: Arc<RwLock<HashMap<String, WiredScope>>>

Scope registry for application variables — write-gates app.* mutations declared with [role] brackets (rebuilt on application.what reload)

policies: Arc<PolicyRegistry>

Compiled collection authorization policies (from [collections.*])

data_source_loaded: Arc<RwLock<HashMap<String, Instant>>>

Last refresh timestamps for configured data sources

rate_limiters: Option<RateLimiters>

Rate limiters for login, upload, and action endpoints

log_level: String

Log level string for debug meta injection (dev mode only)

jobs: JobQueue

Background job queue for async operations (session cleanup, email, etc.)

http_client: Client

Shared HTTP client with configurable timeout for external fetch requests

upload_backend: Option<UploadBackend>

Upload storage backend (local filesystem or Cloudflare R2)

datasources: HashMap<String, Datasource>

Named datasources — multiple backends accessible via dsn:name in fetch directives

wired_client_count: Arc<AtomicUsize>

Number of currently connected wired WebSocket clients

validated_actions: Arc<RwLock<HashSet<String>>>

Registry of form action URLs that require validation (populated at render time). When a form with w-validate is rendered, its action is recorded here. On submission, if the action is registered but w-rules is missing, the request is rejected.

activity_log: Arc<Mutex<VecDeque<ActivityEvent>>>

Ring buffer of recent activity (requests, policy denials, fetches) for the dev inspector’s Activity panel. Only written to in dev mode.

Implementations

impl AppState

pub fn record_activity(&self, event: ActivityEvent)

Record an event in the inspector activity feed. No-op outside dev mode, so production requests never touch the lock.

impl AppState

pub fn new(config: Config, root: PathBuf) -> Result<Self>

pub fn with_dev_mode( config: Config, root: PathBuf, dev_mode: bool, ) -> Result<Self>

Create AppState with development mode enabled (includes live reload)

pub async fn init_datasources(&self) -> Result<()>

Run async initialization for datasources that need it (e.g., D1 system tables). Call this after construction from an async context. Fails if any D1 init fails.

pub fn trigger_reload(&self)

Trigger a live reload notification (clears cache and notifies clients)

pub async fn trigger_reload_async(&self)

Trigger live reload — clears cache first, then notifies clients Use this from async contexts to guarantee cache is cleared before reload

pub fn live_reload_receiver(&self) -> Option<Receiver<LiveReloadMessage>>

Get a receiver for live reload messages

pub async fn rebuild_wired_scopes(&self)

Rebuild the wired + app scope registries by scanning all application.what files. Wired scopes filter WebSocket delivery; app scopes gate who may write app.* keys via w-set.

pub async fn get_wired_scope(&self, key: &str) -> WiredScope

Look up the scope for a wired key from the registry (defaults to Public)

pub async fn get_app_scope(&self, key: &str) -> WiredScope

Look up the write-gate scope for an app.* key (defaults to Public).

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.