Struct NextjsBootstrapState 

pub struct NextjsBootstrapState { /* private fields */ }

Next.js client bootstrap state machine.

This tracks hydration-safe runtime initialization with explicit phase transitions, deterministic history, and idempotent re-entry behavior.

Implementations

impl NextjsBootstrapState

pub fn new() -> Self

Creates a new bootstrap state at ServerRendered.

pub fn phase(&self) -> NextjsBootstrapPhase

Returns current bootstrap phase.

pub fn hydration_cycle_count(&self) -> u32

Returns number of hydration cycles observed.

pub fn runtime_generation(&self) -> u32

Returns runtime generation counter.

This increments every time bootstrap reaches RuntimeReady.

pub fn navigation_count(&self) -> u32

Returns number of navigation events processed.

pub fn hot_reload_count(&self) -> u32

Returns number of hot-reload events processed.

pub fn last_failure(&self) -> Option<&str>

Returns last runtime initialization failure reason, if any.

pub fn transition_log(&self) -> &[NextjsBootstrapTransitionRecord]

Returns deterministic transition history.

pub fn start_hydration( &mut self, ) -> Result<bool, NextjsBootstrapTransitionError>

Starts hydration.

This is idempotent when already in Hydrating.

pub fn complete_hydration( &mut self, ) -> Result<bool, NextjsBootstrapTransitionError>

Completes hydration.

This is idempotent when already in Hydrated.

pub fn mark_runtime_ready( &mut self, ) -> Result<bool, NextjsBootstrapTransitionError>

Marks runtime initialization success.

This is idempotent when already in RuntimeReady.

pub fn mark_runtime_failed( &mut self, reason: impl Into<String>, ) -> Result<bool, NextjsBootstrapTransitionError>

Marks runtime initialization failure with a deterministic reason.

pub fn mark_runtime_cancelled( &mut self, reason: impl Into<String>, ) -> Result<bool, NextjsBootstrapTransitionError>

Marks runtime initialization cancellation with a deterministic reason.

pub fn retry_after_failure( &mut self, ) -> Result<bool, NextjsBootstrapTransitionError>

Retries bootstrap after a previous runtime failure.

pub fn on_navigation( &mut self, navigation: NextjsNavigationType, ) -> Result<bool, NextjsBootstrapTransitionError>

Applies a navigation event to bootstrap state.

Soft navigations preserve runtime state. Hard and popstate navigations reset to ServerRendered.

pub fn on_hot_reload(&mut self) -> Result<bool, NextjsBootstrapTransitionError>

Applies a hot-reload event (e.g., Fast Refresh).

This forces re-hydration from active or failed runtime phases while preserving deterministic bookkeeping.

Trait Implementations

impl Clone for NextjsBootstrapState

fn clone(&self) -> NextjsBootstrapState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for NextjsBootstrapState

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

Formats the value using the given formatter.

impl Default for NextjsBootstrapState

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for NextjsBootstrapState

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for NextjsBootstrapState

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for NextjsBootstrapState

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

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for NextjsBootstrapState

impl StructuralPartialEq for NextjsBootstrapState