use crate::asset::{ AssetBacklogInfo, AssetBacklogPosition, AssetEntry, AssetId, AssetLoadError, AssetOpStatus, AssetTargetStatus, BankTelemetry, BankType, HandleId, LoadStatus, PreloadEntry, SlotRef, SlotStats, }; use crate::cartridge::AssetsPayloadSource; pub trait AssetBridge { /// Bind before cartridge preload/loading. Hosts supporting memcard must use /// this same lane for assets; an unsupported bridge refuses the fast profile. fn bind_background_work( &mut self, _lane: std::sync::Arc, ) -> bool { false } fn initialize_for_cartridge( &self, assets: Vec, preload: Vec, assets_data: AssetsPayloadSource, ); /// Admission waits until all preloads are installed. Failure blocks guest boot. fn preloads_ready(&self) -> Result { Ok(true) } fn load(&self, asset_id: AssetId, slot_index: usize) -> Result; fn status(&self, handle: HandleId) -> LoadStatus; fn commit(&self, handle: HandleId) -> AssetOpStatus; fn cancel(&self, handle: HandleId) -> AssetOpStatus; fn backlog_info(&self) -> AssetBacklogInfo; fn backlog_position(&self, handle: HandleId) -> AssetBacklogPosition; fn backlog_move(&self, handle: HandleId, new_position: usize) -> AssetOpStatus; fn backlog_promote(&self, handle: HandleId) -> AssetOpStatus; fn backlog_demote(&self, handle: HandleId) -> AssetOpStatus; fn target_status(&self, bank_type: BankType, slot: usize) -> AssetTargetStatus; fn apply_commits(&self); fn bank_telemetry(&self) -> Vec; fn slot_info(&self, slot: SlotRef) -> SlotStats; fn shutdown(&self); }