Struct ManagementState 

pub struct ManagementState {

    pub mocks: Arc<RwLock<Vec<MockConfig>>>,
    pub spec: Option<Arc<OpenApiSpec>>,
    pub spec_path: Option<String>,
    pub port: u16,
    pub start_time: Instant,
    pub request_counter: Arc<RwLock<u64>>,
    pub proxy_config: Option<Arc<RwLock<ProxyConfig>>>,
    pub state_machine_manager: Arc<RwLock<ScenarioStateMachineManager>>,
    pub ws_broadcast: Option<Arc<Sender<MockEvent>>>,
    pub lifecycle_hooks: Option<Arc<LifecycleHookRegistry>>,
    pub rule_explanations: Arc<RwLock<HashMap<String, RuleExplanation>>>,
    pub server_config: Option<Arc<RwLock<ServerConfig>>>,
    pub base_path: Option<String>,
}

Shared state for the management API

Fields

mocks: Arc<RwLock<Vec<MockConfig>>>

Collection of mock configurations

spec: Option<Arc<OpenApiSpec>>

Optional OpenAPI specification

spec_path: Option<String>

Optional path to the OpenAPI spec file

port: u16

Server port number

start_time: Instant

Server start time for uptime calculation

request_counter: Arc<RwLock<u64>>

Counter for total requests processed

proxy_config: Option<Arc<RwLock<ProxyConfig>>>

Optional proxy configuration for migration pipeline

state_machine_manager: Arc<RwLock<ScenarioStateMachineManager>>

State machine manager for scenario state machines

ws_broadcast: Option<Arc<Sender<MockEvent>>>

Optional WebSocket broadcast channel for real-time updates

lifecycle_hooks: Option<Arc<LifecycleHookRegistry>>

Lifecycle hook registry for extensibility

rule_explanations: Arc<RwLock<HashMap<String, RuleExplanation>>>

Rule explanations storage (in-memory for now)

server_config: Option<Arc<RwLock<ServerConfig>>>

Optional server configuration for profile application

base_path: Option<String>

Issue #79 round 20 — the API base path the server was started with (e.g. /api). When MOCKFORGE_SHADOW_MODE=true, the dynamic-mock fallback returns 200 only for requests whose path is under this prefix, and 404 otherwise. Pre-round-20, shadow returned 200 for every unmatched path, including paths outside the configured surface (e.g. /api123/... when the server is /api). Empty or None means no prefix gate.

Implementations

impl ManagementState

pub fn new( spec: Option<Arc<OpenApiSpec>>, spec_path: Option<String>, port: u16, ) -> Self

Create a new management state

Arguments

• spec - Optional OpenAPI specification
• spec_path - Optional path to the OpenAPI spec file
• port - Server port number

pub fn with_base_path(self, base_path: Option<String>) -> Self

Set the API base path (e.g. /api). Required for shadow-mode’s base-path gate (#79 round 20). Normalises by trimming trailing /, and treats empty / / as None.

pub fn with_lifecycle_hooks(self, hooks: Arc<LifecycleHookRegistry>) -> Self

Add lifecycle hook registry to management state

pub fn with_ws_broadcast(self, ws_broadcast: Arc<Sender<MockEvent>>) -> Self

Add WebSocket broadcast channel to management state

pub fn with_proxy_config(self, proxy_config: Arc<RwLock<ProxyConfig>>) -> Self

Add proxy configuration to management state

pub fn with_server_config( self, server_config: Arc<RwLock<ServerConfig>>, ) -> Self

Add server configuration to management state

Trait Implementations

impl Clone for ManagementState

fn clone(&self) -> ManagementState

Returns a duplicate of the value.

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

Performs copy-assignment from source.