Struct ParentalStore

pub struct ParentalStore { /* private fields */ }

Protected installation-level parental policies and conservative usage ledger.

Implementations

impl ParentalStore

pub fn check_schedule( &self, owner: &str, now: u64, media: &Media, ) -> Result<(), String>

Recheck current category and clock windows without spending an existing grant twice.

pub fn status( &self, owner: &str, now: u64, media: &Media, ) -> Result<Status, String>

Inspect only one owner’s policy and reserved/settled local calendar budgets.

pub fn reserve( &mut self, owner: &str, lease_id: &str, media: Media, requested_seconds: u32, now: u64, ) -> Result<LeaseGrant, String>

Reserve at most ten seconds before audio is admitted. The caller saves before granting. Overlapping transports share temporal coverage rather than spending their duration twice.

pub fn settle( &mut self, owner: &str, lease_id: &str, consumed_ms: u64, now: u64, close: bool, ) -> Result<(), String>

Confirm cumulative consumed milliseconds and close/refund only future activity. Already elapsed time under an active grant is never refunded by a client’s counter. Expired reservations stay fully charged; a crash or late client cannot regain their budget.

pub fn renew( &mut self, owner: &str, lease_id: &str, consumed_ms: u64, requested_seconds: u32, now: u64, ) -> Result<LeaseGrant, String>

Atomically settle a previous grant and reserve the next slice under the same identifier. Consumption counters restart at zero for the returned grant.

impl ParentalStore

pub fn load(path: &Path) -> Result<Self, String>

Load a private regular document; only initial absence yields an empty store.

pub fn load_optional(path: &Path) -> Result<Option<Self>, String>

Distinguish initial absence from a present private document at the read boundary. Servers can latch observed presence and refuse a subsequent disappearance.

pub fn save(&self, path: &Path) -> Result<(), String>

Publish one validated replacement atomically; the caller holds StoreLock.

pub fn policy(&self, owner: &str) -> PolicySnapshot

Return only the selected owner’s policy, including explicit unrestricted defaults.

pub fn set_policy( &mut self, owner: &str, policy: Policy, expected_revision: u64, ) -> Result<PolicySnapshot, String>

Replace an administrator-approved policy without altering credentials or opinions.

pub fn set_policy_by( &mut self, owner: &str, administrator: Option<&str>, policy: Policy, expected_revision: u64, ) -> Result<PolicySnapshot, String>

Apply an authenticated administrator’s edit and claim/release its exclusive lock. Legacy unclaimed rules may be claimed; a local token cannot override a named owner.

pub fn supervises(&self, administrator: &str) -> bool

Whether an administrator still owns at least one active supervision lock.

Trait Implementations

impl Clone for ParentalStore

fn clone(&self) -> ParentalStore

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ParentalStore

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

Formats the value using the given formatter.

impl Default for ParentalStore

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ParentalStore

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for ParentalStore

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

where __S: Serializer,

Serialize this value into the given Serde serializer.