Skip to main content

MesofactRevalidateReceiver

Struct MesofactRevalidateReceiver 

Source
pub struct MesofactRevalidateReceiver {
    pub routes: Vec<String>,
    pub publish_config: String,
    pub mirror_key_env: Option<String>,
    pub env: BTreeMap<String, String>,
    pub feeds: Vec<AlmanacFeed>,
    pub feed_runtime: Option<String>,
    pub feed_interval_secs: u64,
    pub feed_project_prefix: Option<String>,
}
Expand description

Revalidate receiver config (R330-F12) — tells kamaji to fork a second mesofact serve --revalidate process alongside the static bundle server.

The receiver is the almanac push endpoint: a lightweight resident axum server mounting POST /dawn (plus the legacy /revalidate alias) that boots V8 on each poke, re-renders the invalidated route, publishes to R2/CDN, then drops the isolate.

Fields§

§routes: Vec<String>

Routes the receiver accepts pokes for (allowlist). Empty vec → all routes in the workload’s manifest are revalidatable.

§publish_config: String

Path to mesofact.config.toml carrying the [publish] block (bucket / zone / env-named credentials). Relative to the workload directory. Default: "mesofact.config.toml".

§mirror_key_env: Option<String>

Env var name holding the bearer secret for this tenant, resolved at deploy time and set as MESOFACT_MIRROR_KEY on the receiver process. None → open receiver (no bearer check).

§env: BTreeMap<String, String>

Environment variables set on the revalidate process by kamaji. Keys are the canonical env var names (MESOFACT_S3_ACCESS_KEY_ID, MESOFACT_S3_SECRET_ACCESS_KEY, CLOUDFLARE_API_TOKEN, MESOFACT_MIRROR_KEY). Values are resolved from the keystore at deploy time — the node never sees slot names.

§feeds: Vec<AlmanacFeed>

Feed-fetch tier (R330-F31) — the almanac feeds whose artifacts must be refreshed on the node for a poke to have anything new to render.

Empty → no fetcher; the receiver re-renders whatever data the bundle was built with (correct for a site whose data only changes at build time, silently stale for one whose data is a live feed). Non-empty → kamaji forks a third resident process, the almanac-feed fetcher, next to the receiver — resolved from the bundle’s bins/<triple>/almanac-feed when it carries one, else from feed_runtime.

§feed_runtime: Option<String>

Runtime ref the almanac-feed fetcher resolves from the node’s shared runtime-asset cache when the bundle carries no bins/ (R746-T3), e.g. "almanac-feed/0.8.22".

This is what lets a vanilla bundle have a feed tier at all. A self-contained bundle stages the fetcher into bins/ and stays closed over it; a vanilla bundle carries no binaries by construction, so the fetcher has to be a node-level asset for the same reason serve is — otherwise a templates-only sync would still need a cross-built musl binary sitting on the syncing machine’s disk.

None with feeds non-empty and no sidecar in the bundle is a deploy failure, named at the node. It is not a silent skip: “the site serves but its data is frozen” is the exact state R330-F31 exists to make observable.

§feed_interval_secs: u64

Seconds between feed-fetch ticks. Ignored when feeds is empty.

This is the site’s freshness bound: a release lands, and the next tick refreshes + pokes. FeedRunner’s change-suppression means an idle tick costs one conditional fetch, so a short interval is affordable.

§feed_project_prefix: Option<String>

Workspace-relative path of the component whose build produced this bundle, e.g. app/yah/web/marketing (R330-F31).

Reconciles two roots for one file: a feed declares emit.artifact workspace-relative (that is where it is authored), while the route declares the same file project-relative (that is what the bundle carries). The fetcher strips this prefix to get from one to the other. None → the two already coincide.

Trait Implementations§

Source§

impl Clone for MesofactRevalidateReceiver

Source§

fn clone(&self) -> MesofactRevalidateReceiver

Returns a duplicate of the value. Read more
1.0.0 (const: unstable) · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for MesofactRevalidateReceiver

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<'de> Deserialize<'de> for MesofactRevalidateReceiver

Source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
Source§

impl Eq for MesofactRevalidateReceiver

Source§

impl PartialEq for MesofactRevalidateReceiver

Source§

fn eq(&self, other: &MesofactRevalidateReceiver) -> bool

Equality operator ==. Read more
1.0.0 (const: unstable) · Source§

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=. Read more
Source§

impl Serialize for MesofactRevalidateReceiver

Source§

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>
where __S: Serializer,

Serialize this value into the given Serde serializer. Read more
Source§

impl StructuralPartialEq for MesofactRevalidateReceiver

Source§

impl TS for MesofactRevalidateReceiver

Source§

type WithoutGenerics = MesofactRevalidateReceiver

If this type does not have generic parameters, then WithoutGenerics should just be Self. If the type does have generic parameters, then all generic parameters must be replaced with a dummy type, e.g ts_rs::Dummy or ().
The only requirement for these dummy types is that EXPORT_TO must be None. Read more
Source§

type OptionInnerType = MesofactRevalidateReceiver

If the implementing type is std::option::Option<T>, then this associated type is set to T. All other implementations of TS should set this type to Self instead.
Source§

fn ident(cfg: &Config) -> String

Identifier of this type, excluding generic parameters.
Source§

fn docs() -> Option<String>

JSDoc comment to describe this type in TypeScript - when TS is derived, docs are automatically read from your doc comments or #[doc = ".."] attributes
Source§

fn name(cfg: &Config) -> String

Name of this type in TypeScript, including generic parameters
Source§

fn decl_concrete(cfg: &Config) -> String

Declaration of this type using the supplied generic arguments. The resulting TypeScript definition will not be generic. For that, see TS::decl(). If this type is not generic, then this function is equivalent to TS::decl().
Source§

fn decl(cfg: &Config) -> String

Declaration of this type, e.g. type User = { user_id: number, ... }. This function will panic if the type has no declaration. Read more
Source§

fn inline(cfg: &Config) -> String

Formats this types definition in TypeScript, e.g { user_id: number }. This function will panic if the type cannot be inlined.
Source§

fn inline_flattened(cfg: &Config) -> String

Flatten a type declaration. This function will panic if the type cannot be flattened.
Source§

fn visit_generics(v: &mut impl TypeVisitor)
where Self: 'static,

Iterates over all type parameters of this type.
Source§

fn output_path() -> Option<PathBuf>

Returns the output path to where T should be exported, relative to the output directory. The returned path does not include any base directory. Read more
Source§

fn visit_dependencies(v: &mut impl TypeVisitor)
where Self: 'static,

Iterates over all dependency of this type.
Source§

fn dependencies(cfg: &Config) -> Vec<Dependency>
where Self: 'static,

Resolves all dependencies of this type recursively.
Source§

fn export(cfg: &Config) -> Result<(), ExportError>
where Self: 'static,

Manually export this type to the filesystem. To export this type together with all of its dependencies, use TS::export_all. Read more
Source§

fn export_all(cfg: &Config) -> Result<(), ExportError>
where Self: 'static,

Manually export this type to the filesystem, together with all of its dependencies. To export only this type, without its dependencies, use TS::export. Read more
Source§

fn export_to_string(cfg: &Config) -> Result<String, ExportError>
where Self: 'static,

Manually generate bindings for this type, returning a String. This function does not format the output, even if the format feature is enabled. Read more

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. Read more
Source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,

Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Checks if this value is equivalent to the given key. Read more
Source§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

Source§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = !

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, !>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.