Struct SingBoxProfileConfigurationAdapter 

pub struct SingBoxProfileConfigurationAdapter { /* private fields */ }

Owns sing-box native validation and its active JSON file.

apply_and_readback validates before replacing the file, installs the exact submitted bytes atomically, and verifies those bytes from disk. The caller still owns process restart/readiness and must not treat this file receipt as proof that a running core loaded the document. Transactions are serialized per adapter instance. A config path must have exactly one adapter owner; separate instances or processes sharing it are not locked.

Implementations

impl SingBoxProfileConfigurationAdapter

pub fn with_tokio(binary_path: PathBuf, config_path: PathBuf) -> Self

Creates the adapter that launches the binary through tokio.

pub fn new( binary_path: PathBuf, config_path: PathBuf, command: Arc<dyn SingBoxCommandPort>, ) -> Self

Creates the adapter with an injected command boundary.

pub async fn validate_native( &self, raw_bytes: &[u8], ) -> Result<DocumentValidation, PortError>

Validates the document with the native sing-box check transaction.

A document that the JSON codec rejects is never staged; a document the codec accepts is staged in a temporary file and checked by the engine.

pub async fn apply_and_readback( &self, raw_bytes: &[u8], ) -> Result<SingBoxConfigApplyReceipt, PortError>

Validates, installs and reads back the exact submitted bytes.

A read-back that does not match rolls the previous file back and reports the typed failure.

pub async fn readback(&self) -> Result<Vec<u8>, PortError>

Reads the exact bytes of the active configuration file.

pub async fn file_state(&self) -> Result<SingBoxConfigFileState, PortError>

Reads the exact state of the active configuration file.

pub async fn restore_file_state( &self, expected: &SingBoxConfigFileState, ) -> Result<(), PortError>

Restores a transaction snapshot and verifies the resulting file state.