Skip to main content

Crate mesofact_core

Crate mesofact_core 

Source
Expand description

mesofact — tri-mode web server library + proxy binary. See .yah/docs/working/mesofact.md for the phased rollout plan.

@yah:ticket(R009-T1, “Add axum/tokio deps + binary scaffold + proxy module export”) @yah:at(2026-05-15T23:55:09Z) @yah:status(review) @yah:parent(R009)

Re-exports§

pub use cache_policy::CachePolicyTable;
pub use manifest::CachePolicy;
pub use manifest::ErrorRoutes;
pub use manifest::Hydration;
pub use manifest::Manifest;
pub use manifest::Prerender;
pub use manifest::Requires;
pub use manifest::Route;
pub use manifest::RouteMode;
pub use manifest::StaticAsset;
pub use manifest::MANIFEST_VERSION;
pub use policy::check_manifest;
pub use policy::PolicyCheckError;
pub use policy::PolicyRefusal;
pub use policy::PolicySupport;
pub use policy::RoutePolicy;
pub use proxy::cache::compose_key;
pub use proxy::cache::CacheEntry;
pub use proxy::cache::CacheState;
pub use proxy::cache::KeyInputs;
pub use proxy::cache::ResponseCache;
pub use proxy::session::CookieSessionResolver;
pub use proxy::session::SessionResolver;
pub use proxy::session::User;
pub use proxy::source_gen::Generations;
pub use validate::validate;
pub use validate::SourceCatalog;
pub use validate::SourceScope;
pub use validate::ValidationError;
pub use validate::ValidationErrorKind;

Modules§

cache_policy
The one derivation of cache_policy → response headers (R749-T1, R749-B4).
manifest
Manifest types — the single document the build emits and the proxy boots from. Mirrors packages/mesofact-runtime/src/manifest.ts. Schema spec lives in .yah/docs/architecture/mesofact.md §“Manifest schema”.
policy
Declared-vs-enforced route policy (R749-T1) — the general form of the rule crate::manifest fields keep re-learning one field at a time.
proxy
axum proxy — boot, manifest reload, Mode 1 dispatch, worker pool, and the P9 Mode 2 SSR slice (response cache + cache-key composition + session + source generations). Mode 3 dispatch is stubbed (501) — wired up in P10. See .yah/docs/architecture/mesofact.md §“IPC protocol” and §“Components”.
validate
Manifest validator — semantic rules over a parsed Manifest. Mirrors packages/mesofact-runtime/src/validate.ts. Used by the proxy on boot (refuse a malformed manifest, keep the old one live) and by the build to reject forbidden shapes before HTML hits R2.